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Preface 



The DX10 3270 Interactive Communications Software (ICS) provides a 990 family computer with 
the DX10 operating system to emulate the operation of a subset of the IBM 3270 Information 
Display System. This emulation allows an ICS-supported video terminal, or any DX10-supported 
sequential output device, to receive data from an IBM host application program. When an ICS 
display station receives the data, the operator can read, delete, or modify it, then send it back to 
the host application. The operator can also put the data onto a file or print a copy of it. 

An ICS printer station is a receive-only device. Once activated, the printer station can receive data 
transmitted by the host application program and either print a copy of it or write it onto a file 
without requiring an operator. ICS can also use a program that you design as an ICS display or 
printer station. 

This manual describes the operation of the ICS display station and the ICS printer station and 
provides instructions for activating and terminating ICS. Also, this document describes how a 
user-written program can operate as an ICS display or printer station. 

This manual addresses three audiences. Section 1 contains general information concerning the 
scope of the ICS package. Section 2 provides background information about the IBM 3270 
Information Display System and the DX10 operating system. Section 2 requires no technical 
knowledge and serves as an introduction for those users unfamiliar with either of these systems. 
Section 3 contains all the information required for a data entry operator to activate, operate, and 
terminate an ICS station. Section 4 contains information useful to both the systems operator and 
the systems analyst. Section 5 and the appendixes contain technical information for the systems 
analyst. Appendix A contains generic keyboard references. Appendix B contains explanations of 
the errors returned by ICS. Most errors can be corrected by the data entry operator, though some 
require attention by the systems operator or the systems analyst. 
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This manual is organized into the following sections and appendixes: 
Section 

1 General Description — Introduces Interactive Communications Software (ICS) and its 
capabilities, and Programmed Station Control (PSC) and its capabilities. 

2 Functional Environment — Describes the components and operational requirements, 
and the supported configurations. This section also explains how the operating system 
treats user responses to command prompts. 

3 ICS Station Operation — Describes the activation, termination, and operation of the ICS 
printer and video stations. 

4 Functional Description — Describes the installation process, ICS line activation, 
configuration management utilities, and the statistics kept by ICS. 

5 Programmed Station Control (PSC) — Describes PSC, its capabilities, and its operation. 
Appendix 

A Generic Keynames — Describes the generic keynames for video terminals. 

B ICS Messages and Codes — Describes the error messages that may be logged or 
displayed during operation of ICS or PSC. 

C ICS Hardware Requirements — Describes the memory and hardware requirements of 
the ICS and PSC. 

D ASCII/EBCDIC, EBCDIC/ASCII Translation Table — Describes the EBCDIC character set 
supported for an ICS station and provides the ASCII-to-EBCDIC and EBCDIC-to-ASCII 
code translations. 

E Summary of ICS Commands and Key Functions — Provides a complete list of ICS SCI 
commands and special key functions the ICS supports. 

F Binary Synchronous Communications (BSC) Procedures — Describes the protocol that 
ICS uses to communicate with an IBM-compatible host computer. 
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The following documents contain information about the DX10 operating system, the video 
terminals that ICS supports, and the printers that the operating system supports. 

Title Part Number 

0X70 Operating System Concepts and Facilities 946250-9701 
(Volume I) 

DX10 Operating System Operations Manual 946250-9702 
(Volume II) 

DX10 Operating System Application Programming 946250-9703 
Guide (Volume III) 

DX10 Operating System Text Editor Manual 946250-9704 
(Volume IV) 

DX10 Operating System Systems Programming 946250-9705 
Guide (Volume V) 

DX10 Operating System Error Reporting and 946250-9706 
Recovery Manual (Volume VI) 

DX10 Operating System Link Editor Reference Manual 94961 7-9701 

Operator's Guide Business System Series 253331 8-9701 

DX10 3270 Interactive Communications Software 2250942-9701 
(ICS) Object Installation 

Release Information, DX10 3270 Interactive 2250945-9901 
Communications Software (ICS), Release 2.2.0 

DX10 Operating System COBOL Programmer's Guide 2270521-9701 

COBOL Reference Manual 227051 8-9701 

DX10 FORTRAN-78 Programmer's Guide 2268679-9701 

FORTRAN-78 Reference Manual 2268681-9701 

DX10 Tl Pascal Programmer's Guide 2270528-9701 

Tl Pascal Reference Manual 227051 9-9701 

990/9900 Assembly Language Reference Manual 2270509-9701 

Model 990/10 Minicomputer System Hardware 94541 7-9701 
Reference Manual 
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Title 

Model 911 Video Display Terminal 
Installation and Operation Manual 

Model 931 Video Display Terminal 
Installation and Operation Manual 

Model 940 Electronic Video Terminal 
Installation and Operation Manual 

Models 306 and 588 Line Printers 
Installation and Operation Manual 

Model 810 Printer Installation and Operation 

Models 2230 and 2260 Line Printers 
Installation and Operation 

Model LP300 and LP600 Line 

Printers Installation and Operation Manual 

Model LQ45 Letter Quality Printer 
System Installation and Operation Manual 

Bit-Oriented/Character-Orien ted/ A synchronous 
Interface Module Installation and Operation Manual 

Four Channel Communications 

Controller Installation and Operation Manual 

Remote Terminal Subsystem 
(RTS) Hardware Installation Manual 
Domestic Edition 

DX10 Remote Terminal 
Subsystem (RTS) Operator's Guide 

Remote Terminal Subsystem 
(RTS) Site Preparation Manual 

DX10 Remote Terminal 

Subsystem (RTS) System Generation and 

Programmer's Reference Manual 



Part Number 

945423-9701 

2229228-0001 

2250368-9701 

945261-9701 

939460-9701 
946256-9701 

2250364-9701 

2268695-9701 

2263886-9701 

2263878-9701 

2272053-9702 

2272055-9701 
2250385-9701 
2272054-9701 
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The following IBM documents provide additional information concerning the interaction between 
an IBM host system and an IBM 3270 Information Display System. 

Title Part Number 

IBM 3270 Information Display System GA27-2749 

Component Description 

IBM General Information — Binary GA27-3004 

Synchronous Communications 
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General Description 



1.1 INTRODUCTION 

The DX10 3270 Interactive Communications Software (ICS) allows a 990 system to emulate a sub- 
set of the IBM 3270 Information Display System. ICS also provides the Business System 300 with 
the same capability. This emulation enables these computers to communicate interactively with a 
host computer in much the same way as an IBM 3270 Information Display System. Therefore, you 
can interact with a wide range of inquiry and/or data entry applications designed for the IBM 3270 
Information Display System. ICS provides this capability without losing any of the multitasking 
capabilities of the 990 family computer. ICS also provides Programmed Station Control (PSC), 
which allows a user-written program to substitute as operator of an ICS station. 

This section provides a general description of the 3270 ICS emulator used with the 990 family 
computer. It discusses the terminology and conventions used in this manual and identifies the 
components necessary for 3270 emulation. This section lists the features of standard IBM 3270 
that are supported and those that are not. This section also lists features of this package that are 
not standard to IBM 3270. Consult the Release Information, DX10 3270 ICS for the current release 
to find out which releases of the DX10 operating system support the current release of DX10 3270 
ICS. 



1.2 TERMINOLOGY 

ICS is an acronym for Interactive Communications Software. Throughout this manual, the DX10 
3270 ICS emulator is abbreviated as ICS. 

A local station is a terminal connected directly to the computer that controls it, without using 
modems and telephone (or equivalent) lines. Local stations send digital data signals back and 
forth across relatively short distances. 

A remote station is a terminal that communicates with the computer that controls it through 
modems and some form of communications line. Modems transform the digital output of the 
computer (discrete logic that is either on or off) into analog form suitable for long-distance trans- 
mission. The distance between the remote terminal and its computer need not be long-distance, 
but there is no limit to the distance possible between the two. 

The host computer is any IBM 3270-compatible computer. This computer is not necessarily an IBM 
computer, but can be any computer that serves as an IBM 3270 host. The host is the computer with 
which an ICS terminal communicates interactively. 

A communications session is defined as the period from ICS station activation to termination. 
During this time, necessary system resources (such as a unique 3270 terminal address) are 
reserved for the active local station. 
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A poll is the operation the host performs by to invite transmission. There are two types of polls. A 
general poll invites transmission from any device or emulator on a particular control unit. A 
specific poll invites transmission only from a specific device or emulator on a particular control 
unit. Upon receiving the poll, the device or emulator either sends data or responds that it has no 
data to send at this time. 

A select is the operation the host performs when it initiates transmission to a particular device on 
a 3271 control unit or emulator on the line. After the control unit acknowledges the select, the host 
begins transmitting. 

DX10 System Command Interpreter (SCI) commands activate ICS and provide auxiliary services. 
Those SCI commands that service ICS are not standard DX10 commands but are added during 
ICS installation. Appendix E contains a complete list of DX10 SCI commands unique to ICS 
installation. 



1.3 CONVENTIONS USED IN THIS MANUAL 

The video display terminals (VDTs) that ICS supports can display characters on the screen in high 
and low intensity. These terminals display SCI prompts in low intensity. When you enter charac- 
ters from the keyboard, the system displays those characters in high intensity. This manual shows 
operator entries underlined. Low intensity displays appear in standard type. SCI frequently sup- 
plies initial default values to the prompts that it displays. These initial values are displayed in low 
intensity on the VDT and in standard uppercase type in this manual. The following is an example 
of how this manual depicts operator entries: 

[ ] XICT 

EXECUTE INTERACTIVE COMMUNICATIONS TERMINAL 
COMMUNICATIONS LINE NAME: CM01 
TERMINAL ADDRESS (0-31 ) : 

PRINT KEY PATHNAME: DATA . MARCH . W I G I TS 
UNPROTECTED FIELD INDICATOR: YES 

The brackets ( [ ] ) represent the SCI prompt, and XICT represents the response you enter to SCI. 
Usually, SCI recognizes only uppercase characters, for this reason use the SHIFT key in conjunc- 
tion with the data keys or be sure that the UPPERCASE LOCK key is engaged. DX10 provides an 
option that maps lowercase input to uppercase so that you can respond with lowercase, 
uppercase, or a mixture of both. Consult your systems operator to determine whether this option 
is enabled. After typing the SCI command XICT, press the RETURN key to initiate servicing by SCI. 
Other keys, such as ENTER and NEXT FIELD, accomplish the same function. Throughout this 
manual, it is assumed that the operator presses the RETURN (or equivalent) key after entering 
values into a field. After you enter XICT, ICS displays on the screen the SCI command procedure 
name, the field prompts for the procedure, and any initial values that may be supplied. 
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The CM01 next to the COMMUNICATIONS LINE NAME prompt is depicted in standard type indi- 
cating that it is an initial value supplied by SCI. If you press the RETURN key, the value CM01 is 
entered as if you had manually typed it. No response is shown next to the TERMINAL ADDRESS 
(0-31) prompt. None is required, and no initial value is given for this field. Pressing the RETURN 
key moves the cursor to the next prompt and enters a null value into the terminal address field. 
Where null responses are accepted, ICS uses a default value. DATA.MARCH.WIGITS is underlined 
to indicate that the operator typed it. 

The XICT command is shown here only to illustrate the conventions used throughout this manual. 
Paragraph 3.2.1 details the XICT command. 



1.4 EMULATOR COMPONENTS 

A 990 computer can use ICS to communicate with any host computer that supports an IBM 3271 
Model 2 Control Unit. The following paragraphs compare the components of the IBM 3270 Infor- 
mation Display System with the components ICS uses. 

1 .4.1 IBM 3270 Information Display System 

This paragraph describes the IBM 3270 Information Display System that ICS emulates. Figure 1-1 
shows a typical configuration of the IBM 3270 Information Display System. The main components 
of the system are a communications line, a modem, a transmission control unit, display stations, 
and printer stations. 

The communications line is a dedicated line, usually a leased telephone line. Each control unit on 
the line uses a modem to translate digital signals into a form suitable for transmission across the 
communications line. 

The host computer identifies each individual 3271 control unit by a unique IBM control unit 
address. Up to 32 control units can share the same communications line. The host can communi- 
cate with any individual 3271 control unit on the line. But, two 3271 control units cannot communi- 
cate directly. Each 3271 control unit on the communications line can have several 3277 display 
stations and 3284 printer stations attached to it. The shaded area of Figure 1-1 shows the compo- 
nents emulated by ICS installed on a Tl computer. 

Figure 1-2 provides a more detailed view of the IBM. components that ICS emulates. The figure 
shows a single IBM 3271 Model 2 Control Unit and its modem, display stations, and printer 
stations. At least one 3277 display station must be attached. Usually, at least one 3284 printer 
station is present. Up to 32 stations (display or printer) can be attached to one control unit. Each 
station is assigned an IBM terminal address to identify it to the host. 
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Figure 1-1. IBM 3270 Information Display System Configuration 
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Figure 1-2. 3271 Control Unit Cluster 



1.4.2 ICS Configuration 

This paragraph briefly describes the components that ICS uses to emulate the 3270 system. Sec- 
tion 2 gives a more detailed description, and Appendix C summarizes hardware requirements. 

Figure 1-3 shows a typical configuration of a 990 computer using ICS to communicate with a host 
computer. 

The practical maximum number of active ICS stations that DX10 can support depends on the 
memory size, the hardware supported by the system, and the acceptable response time for a par- 
ticular host application. ICS supports the maximum number of terminal addresses supported by a 
standard 3271 control unit, which is 32. The minimum configuration required for operation of ICS 
is a video terminal, a communications controller, a modem, and a communications line. PSC pro- 
grams can serve in place of ICS video and printer stations. Printer devices are not required. 
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Figure 1-3. ICS Configuration 
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1.4.2.1 Video Terminals. ICS supports the following video terminals: 

• Model 91 1 Video Display Terminal (VDT) 

• Model 915 Remote Video Terminal (RVT) 

• Model 931 Video Display Terminal (VDT) 

• Model 940 Electronic Video Terminal (EVT) 

• Business System Terminal 

When installed on a DX10 operating system, these terminals can serve as ICS stations. An ICS 
station requires no special installation procedure. Any of these terminals can be attached 
remotely using an additional communications link (Figure 1-4). The 915 RVT can share a Remote 
Terminal Subsystem (RTS) port with clusters of 911 VDTs. Business System terminals and 940 
EVTs can use the same communications port using a switched line, but not simultaneously. If a 
terminal is connected to the communications port, no other terminal can use that port until the 
first terminal ends the communications session. You can attach the Business System Terminal 
and the 940 EVT either locally or remotely. When used as ICS stations, remotely attached termi- 
nals operate the same as locally attached terminals. 

1.4.2.2 Printer Stations. Any printer or file device that runs under DX10 can serve as an ICS 
printer station. In addition to the use of a printer, ICS can copy data onto a file on a magnetic 
medium. You can print this file at any convenient time. DX10 supports several types of hard disk 
media, magnetic tape, single-sided flexible diskettes, and double-sided, double-density (DSDD) 
flexible diskettes. DX10 also supports several types of printers, including dot matrix, high-speed 
drum, and letter quality. Any sequential output device installed on the DX10 operating system can 
serve as an ICS printer station. DX10 requires no special installation procedures. 

1 .5 OPERATIONAL DESCRIPTION 

When you install ICS on a 990 system, you must specify several parameters to identify the compo- 
nents of the system. 

Up to 32 control units or emulators can share the same communications line. ICS and 3271 control 
unit clusters can share the same line, as shown in Figure 1-4. 

The 3271 control unit address identifies to the host a particular control unit or 3270 emulator. 
When polling or selecting, the host uses this value to specify one control unit or emulator on the 
communications line. This value must be installed on both the host and local DX10 system. A 
DX10 system can have more than one ICS communications line installed. When two lines are 
installed, you must specify the desired communications line. In most configurations, ICS can 
select the correct line, but when the second line is required, you must specify that line. During 
installation, each ICS line is assigned a control unit address. When activating an ICS line, specify 
the communications line name to which this control unit address is assigned. 
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Figure 1-4. 3270 Clusters and ICS Sharing a Line 
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In addition to the control unit address, all display stations and printer stations are assigned 
terminal addresses so that the host can direct its communications to a specific ICS station. These 
station addresses are allocated during installation but are not assigned to a particular station 
until ICS is activated. When ICS is not active at a particular station, that station is available to ser- 
vice any other application running under DX10. 

The host always transmits the control unit address and terminal address when it attempts to 
select (or poll) a particular terminal. 

Before a particular ICS station can be activated, the ICS line (controller task) must be activated. 
When activated, ICS indicates to the host that the status of the ICS display stations and printer 
stations has changed from not ready to ready. The stations can then be activated and send or 
receive data. If the host attempts to transmit to a station on a DX10 system when no ICS station is 
active, ICS receives and temporarily stores the transmission provided that the local format file 
option was selected during installation. When the host addresses the activated station, ICS for- 
wards the stored transmission to that station. An ICS printer station can only receive data. 

When station activation is complete, ICS displays the data sent from the host application. The ICS 
display station operator can then modify the existing data or enter new data. When an ICS display 
station operator presses one of the keys that initiates a transmission, ICS indicates to the host 
that there is data to transmit. When the host polls that station, ICS sends the data. 

When the host has data to send, it selects ICS for the status of the ICS station where the data is to 
be sent. If the ICS line is active, ICS accepts the data regardless of the status of the station. If the 
station selected is not active, ICS saves the transmission until the selected station is activated if 
you selected the local format file option during installation. If the selected station is active, the 
host forwards the transmission immediately. If you did not select the local format option during 
installation, the host does not transmit data to ICS until the station is active. 

Under Programmed Station Control (PSC) the operation is the same, except that ICS reports to the 
PSC task (user-written program linked with the PSC routines) when it has received data from the 
host and/or when the PSC task is ready to transmit to the host. With PSC, a physical device is not 
required for use as a station. When the PSC task receives a report that the data is ready, the PSC 
task can then read or modify the station buffer the same as an operator. The task can then send 
the data to the host. 



1.6 SUPPORTED FEATURES 

ICS supports the following features of the IBM 3271 Model 2 Control Unit, the IBM 3277 Model 2 
Display Station, and the IBM 3284 Model 2 Printer: 

EBCDIC character set — ICS provides ASCII-to-EBCDIC and EBCDIC-to-ASCII 
translation so that ASCII terminals can communicate with hosts using the EBCDIC 
character set. 

• Data link control — ICS supports all facets of the Binary Synchronous Communications 
(BSC) protocol used by the IBM 3271 Model 2 Control Unit. 

• Key functions — ICS honors all functions of the 66-key and 78-key typewriter and key- 
punch keyboards available for the 3277 display station, except TEST REQ. 
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Line speed — ICS supports line speeds of up to 9600 bits per second. 

Audible alarm — ICS supports an audible alarm that sounds when the operator presses 
specific keys in specific situations. 

Commands — ICS supports the following 3270 Information Display System commands: 



Command 

Write 

Erase/Write 
Read Modified 
Erase All Unprotected 



Description 

Put data into designated fields of the station buffer 
Clear the station buffer and load with data 
Retrieve all modified fields from the station buffer 
Clear all unprotected fields in a station buffer 



Orders — ICS supports all the IBM 3271 Model 2 Control Unit orders as follows: 



Order 

New Line 

Form Feed 

End of Message 

Start of Field 

Set Buffer Address 

Insert Cursor 

Program Tab 

Repeat to Address 

Erase Unprotected 
to address 



Description 

Begin new line in printed output 

Execute form feed to the top of the next printed page 

End of printed output 

Mark the beginning of a field 

Select buffer address 

Position cursor 

Tab to next unprotected field 

Insert the character specified into the station buffer 

Change characters to null values 



International character sets — ICS supports special character sets for the United King- 
dom, France/Belgium, Germany/Austria, Norway/Denmark, Sweden/Finland, and Japan. 
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1.7 EXTENDED FEATURES 

The following features are ICS extensions to the IBM features supported: 

• Lowercase display — An ICS display station can display lowercase characters. 

• File or sequential input/output device — A sequential I/O device or a sequential or rela- 
tive record file can serve as an ICS printer station instead of a printer. 

• Local print capability (PRINT key) — When you press the PRINT key, an ICS display 
station can store the contents of the screen onto a file or print a copy at any DX10- 
supported printer. ICS supports the identification function and also allows you to 
cancel a print in progress. 

• Statistics display — ICS provides displays of ICS activity for accounting or analysis 
purposes. 

• Programmed Station Control (PSC) — Using the PSC routines allows a user-written pro- 
gram to serve as an ICS station. 

• Station suspension — ICS permits the user to temporarily suspend an active ICS dis- 
play station without terminating the session. The operator can temporarily exit ICS 
(saving any transaction in progress), execute SCI commands, then reenter ICS without 
losing any screen data. 

• Virtual operation — Once activated, ICS can receive transmissions from the host even 
though no ICS station is active. ICS acknowledges reception to the host and stores the 
data in a queue. When an ICS station is activated, ICS outputs any queued 
transmissions. 

• Erase-to-end-of-screen function — ICS supports a key function that fills all modifiable 
fields with nulls from the position of the cursor to the end of the display screen. 

• Local duplicate — You can copy the contents of the previous modifiable field into the 
current field. ICS performs this copy locally before it transmits the data to the host. 

• Tab functions — ICS provides two modes of tabbing that allow stopping at either fixed 
tabs or according to the data within a field. You can append the cursor to the end of a 
word, tab to the beginning of a word, or tab to the first character position of the next 
unprotected field. 

• Dynamic configuration — ICS provides utilities that can dynamically modify the 
installed configuration. 

• Limited poll trace — ICS provides a limited poll trace of line activity. 
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1.8 UNSUPPORTED FEATURES 

The following features, available on IBM 3271 Model 2 Control Units, IBM 3277 Model 2 Display 
Stations, and IBM 3284 Model 2 Printers, are not supported by ICS: 

• Selector pen (light pen) — This feature permits you to use a light-pen device to select 
fields of data for input to the host system. 

• Security keylock — This feature allows you to lock the keyboard so that data cannot be 
displayed or modified. 

• Operator identification card reader — A 3277 display station card reader can read a 
small card that identifies the operator to the system, allowing access to the data. 

• Read Buffer and Copy commands — The Read Buffer command allows the application 
program executing at the host to specify that buffer data be transferred to the host sys- 
tem. The Copy command transfers buffer data from one station to another station 
attached to the same 3271 control unit. 

• ASCII transmission code — This feature allows you to transfer data in ASCII code. 

• TEST REQ key — This key initiates a test that is performed on test data that you supply. 
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2.1 INTRODUCTION 

This section describes the configurations of the 990 family computer that support the DX10 3270 
Interactive Communications Software (ICS). The following topics are included: 

The identifiers that the standard 3270 information display system uses and how they are 
processed by ICS 

The prerequisites for ICS operation 

Operating system concepts relevant to ICS operation 

How ICS uses the DX10 System Command Interpreter (SCI), the user interface to the 
operating system 

SCI commands that provide control of ICS 

2.2 SUPPORTED CONFIGURATIONS 

ICS can use several models of video terminals and any printers supported by the DX10 operating 
system. The video and printer stations can be attached locally or remotely. For example, remote 
attachment enables the user of a terminal in California to use the resources of a 990 family com- 
puter in Texas to communicate with a 3270-compatible host computer in Maine. This requires an 
additional communications link consisting of a communications controller, a modem, and a 
communications line (usually a telephone line) between the remote terminal and the 990 com- 
puter. Figure 2-1 shows one possible arrangement of local and remote video terminals configured 
with ICS, operating on a 990 computer system. 

2.2.1 Supported Video Terminals 

ICS can support several models of video terminals attached locally or remotely. The 911 VDT, 915 
RVT, 931 VDT, 940 EVT, and the Business System Terminal are all supported by ICS (Figure 2-2). 
These terminals consist of a video display unit and a cable-attached keyboard. 

The 91 1 VDT and 915 RVT can be identified by the decal in the upper left corner of the keyboard. 
The 931 VDT, 940 EVT, and the Business System Terminal can be identified by the decal on the 
right side of the display housing. The Business System Terminal uses the same video display unit 
as the 940 EVT, but it has a different keyboard. 
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Figure 2-1 . Typical DS990 System Configured With ICS 
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Figure 2-2. ICS Supported Video Terminals 



ICS supports local or remote attachments of the 911 VDT, 931 VDT, 940 EVT, and the Business 
System Terminal. The 915 RVT can only be attached remotely and requires that the Remote 
Terminal Subsystem (RTS) be included. RTS is an add-on package that supports the 915 RVTs. 
When attached remotely, the 911 and 915 terminals rely on the 990 computer to initially load their 
memories. Once the download is successfully completed, these terminals operate the same as 
when attached locally. The download is a function of RTS and is required before you can access 
any application, including ICS. The 931, 940, and the Business System Terminal do not require 
downloading. 

All terminals operate in the same basic manner, although each terminal may require different key 
stroke sequences to accomplish these operations. Each terminal can display uppercase and 
lowercase characters. Some terminals support graphics characters and character sets for differ- 
ent countries. 
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The 915, 931 , and the 940 terminals have their own memory and central processing unit (CPU), but 
they rely on a 990 computer for their initial program load (IPL), task execution, and file access, 
plus other operating system resources. 

For more information regarding a particular terminal(s), refer to the reference material listed 
below. 

• Model 91 1 Video Display Terminal Installation and Operations Guide 

• Model 915 Remote Video Terminal General Description 

• Model 931 Video Display Terminal General Description 

• Model 940 Electronic Video Terminal Installation and Operations Manual 

• Operator's Guide Business System 300 

• Remote Terminal Subsystem Operator's Guide 

2.2.2 Remote Configurations 

All supported video terminals can be remotely attached. RTS supports the 91 1 , 931 , and 915 video 
terminals. Each installed 940 EVT uses its own communications controller, modem, and commu- 
nications line. A Business System terminal installed remotely also uses its own communications 
controller, modem, and communications line. The communications link between the 3270- 
compatible host and the ICS package installed on a 990 family computer must be a dedicated 
(leased or private) line. The links between ICS and remotely configured terminals, however, may be 
either dial-up or dedicated. If the link is dial-up, you must call and make the connection to the 
DX10 operating system before you can download the 915 RVT or the Remote Terminal Controller 
(RTC). This is the only additional step necessary for remote operation of ICS terminals. 

As shown in Figure 2-1, RTS enables the remote attachment of 915 RVTs and RTC clusters to the 
990 family computer. An RTC supports clusters of 911 VDTs and printer stations. For detailed 
information about RTS, refer to the Remote Terminal Subsystem (RTS) Operator's Guide and the 
Remote Terminal Subsystem (RTS) System Programmer's Reference Manual. 

2.2.2.1 Remote Terminal Controller (RTC). Remote VDTs operate under the control of an RTC, 
which is a 990 Model 5 Computer with built-in communications ports. Each RTC can control up to 
eight VDTs and up to three printer devices. Supported printer devices include the Model 810 
Printer, the Model LQ45 Printer, the Model 820 Keyboard Send/Receive (KSR) Data Terminal, and 
the Model 743 KSR Data Terminal. Although ICS does not support keyboard input from the 820 and 
743 KSRs, ICS can use them as printer stations. Other applications can use these terminals as 
data entry terminals. RTS supports multiple RTCs and remote video terminals on the same com- 
munications channel (port). 
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Remote video terminals can share an RTS communications channel with RTCs and other RVTs 
using either a switched or dedicated line. Each RVT can optionally support one Model 810 or 
Model LQ45 Printer. 

VDTs and EVTs are attached remotely through a dedicated controller and cannot share a port with 
RTS. Each remote terminal installed on a 990 family computer must have its own controller. For 
remote terminals, modems are also required for the 990 computer site and the remote terminal. 
The communications line can be either a switched (dial-up) or a dedicated (leased) line. With a 
switched line, more than one terminal can use the communications port (controller), but only one 
terminal can access it at one time. The line remains busy and inaccessible to other terminals until 
the first terminal has ended the communications session and released the line. Only one remote 
terminal can be attached to a dedicated line. Each remote terminal can optionally support one 
printer. 

The Business System terminal attaches remotely through a dedicated controller and cannot share 
a port with RTS. Each Business System terminal installed on an S300 computer must have its own 
controller port. For remote Business System terminals, modems are also required for the host 
computer site and the remote terminal. The communications line can be either a switched (dial-up) 
or a dedicated (leased) line. When using a switched line, more than one Business System terminal 
can use the communications port (controller), but only one terminal can access it at one time. The 
line remains busy and inaccessible to a second terminal until the first has ended the communica- 
tions session and released the line. Only one remote Business System terminal can be attached to 
a dedicated line. This remote line is separate from the ICS line, which connects the S300 computer 
to the 3270 host. The ICS link to the IBM host must be a dedicated line. Each remote Business 
System terminal can optionally support one printer. 

2.2.3 Multiple Channel Installation 

The 990 computer can support more than one ICS communications line. Figure 2-3 illustrates a 
990 computer with two ICS lines installed. The S300 computer supports only one ICS line and can- 
not support combination communications packages. Each ICS line requires a separate communi- 
cations controller port, modem, and leased line. With this configuration, you can access either 
host computer through any ICS supported video terminal installed on the 990 computer. Addi- 
tional ICS channels require additional memory. Each additional ICS channel requires about 4K 
bytes. The exact memory requirements depend on how many terminal addresses are installed on 
the line, the hardware used, and other factors. See Appendix C for detailed information. 
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Figure 2-3. Multiple ICS Configuration 



2.3 3270 IDENTIFIERS 



This paragraph describes the function of IBM controller and terminal addresses and how ICS uses 
them. These values identify the ICS line and individual ICS stations on an ICS line. During installa- 
tion and operation, ICS uses decimal values for these addresses. The range is through 31. ICS 
maps these decimal values into EBCDIC values according to Table 2-1. The EBCDIC values are 
transmitted and received across the line. 
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Table 2-1. Decimal-to-EBCDIC Address Mapping 



Line or 




Line or 




Terminal Address 


IBM Address 


Terminal Address 


IBM Address 


(Decimal) 


(EBCDIC)* 


(Decimal) 


(EBCDIC)* 


00 


>40 


16 


>50 


01 


>C1 


17 


>D1 


02 


>C2 


18 


>D2 


03 


>C3 


19 


>D3 


04 


>C4 


20 


>D4 


05 


>C5 


21 


>D5 


06 


>C6 


22 


>D6 


07 


>C7 


23 


>D7 


08 


>C8 


24 


>D8 


09 


>C9 


25 


>D9 


10 


>4A 


26 


>5A 


11 


>4B 


27 


>5B 


12 


>4C 


28 


>5C 


13 


>4D 


29 


>5D 


14 


>4E 


30 


>5E 


15 


>4F 


31 


>5F 



Note: 

* The right angle bracket (>) preceding a value indicates that the value is a hexa- 
decimal number. 



2.3.1 IBM Control Unit Address 

The host computer uses an IBM controller address to identify a particular 3271 control unit or 
emulator among the 32 possible clusters attached to a communications line. Each 3271 control 
unit or emulator on the line responds only to its control unit address. Two clusters on the same 
line should not have the same control unit address. If a duplication occurs, both clusters try to 
respond to a single host poll. Neither cluster can successfully transmit when this line contention 
problem exists. 

The Tl computer has a control unit address assigned to each installed ICS line. These values need 
not be unique to the Tl computer. If two ICS lines are installed as shown in Figure 2-3, both can 
have the same control unit address because each is connected to a separate host. The assigned 
address must be unique to the host. 

The host polls each addresses individually to determine whether any control unit requires servic- 
ing. Each control unit or emulator on the line responds when it recognizes its EBCDIC control unit 
address. ICS maps this EBCDIC value into decimal as shown in Table 2-1. These values range 
from through 31. The control unit address is assigned to a particular ICS line during ICS installa- 
tion. Refer to paragraph 4.2 for further information about installation. 
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2.3.2 IBM Terminal Address 

The control unit address identifies a particular cluster to the host. The terminal address identifies 
a particular station on that cluster. The number of terminal addresses available to a particular ICS 
line is determined during ICS installation. If only five terminal addresses are reserved for a 
particular ICS line during installation, only five ICS stations can be active on that ICS line at a 
given time. Any installed terminal, however, can be activated as an ICS station on any installed 
ICS line, provided that not all the reserved terminal addresses for that line are in use. 

ICS maps the terminal address from decimal (0-31) to the EBCDIC value used during trans- 
mission as shown in Table 2-1. 



2.4 REQUIREMENTS FOR ICS OPERATION 

The following paragraphs outline ICS hardware requirements and the preliminary software proce- 
dures that you must complete successfully before you can use ICS. 

2.4.1 Hardware Requirements 

ICS requires communications hardware to transmit data between computers and station hard- 
ware to present, modify, or create data. 

2.4.1.1 Communications Hardware. The communications link from the 3270-compatible host 
to the 990 computer with ICS requires the following components: 

• Communications line — A dedicated (nonswitched) line, either leased or private. 

• Modem — A synchronous modem, externally attached to the 990 computer. Where 
digital lines are available, a data services unit (DSU) can be used instead of a synchro- 
nous modem. 

• Communications controller — Any one of the following communications controllers 
(with the appropriate cable): 

— Communications Interface Module (CIM) 

— Four-Channel Communications Controller (FCCC) 

— Bit-Oriented, Character-oriented, Asynchronous Interface Module (BCAIM) 

— X.21 Bit-Oriented, Character-oriented, Asynchronous Interface Module (X.21 
BCAIM) 

— Two-Channel Communications Interface Module for the S300. 
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NOTE 

The CIM appears on the Texas Instruments price list as CI401. The 
FCCC appears on the price list as CP503. The BCAIM appears on 
the price list as CP501. The X.21 appears as CP502. The Two-Chan- 
nel Communications Interface Module appears on the price list as 
CI421. 



These elements are required to make the connection from the host to ICS. They should be properly 
installed and tested before you attempt to use ICS. Appendix B provides more detailed informa- 
tion about the components that make the link (between the 3270 host and the 990 computer) with 
ICS. Additional hardware components are required to make the link from the 990 computer (and 
remote terminals attached to it) by RTS. These components are essentially the same but may also 
include different types of communications lines for switched facilities. Refer to the Remote Ter- 
minal Subsystem (RTS) Hardware Installation Manual and the Remote Terminal Subsystem (RTS) 
Site Preparation Manual. 

2.4.1.2 ICS Station Hardware. ICS can operate without video terminals or printer stations 
when a user-written Programmed Station Control (PSC) task is installed on the system. However, 
the programmer must use a terminal to generate and debug a PSC task. Most 990 computers are 
packaged with multiple terminals and at least one printer. 

2.4.2 Software Requirements 

This paragraph lists the software procedures that must be successfully performed to make ICS 
operational. Section 3 describes ICS station operation and assumes that all these preliminary 
operations are complete. Note that ICS requires access to the System Command Interpreter (SCI). 
Although this access is automatic in some configurations, generally you must log on to a 
terminal. This means bidding the SCI task, which handles the interface between you and the oper- 
ating system. The DX10 Operating System Production Operation Manual, Volume II describes this 
operation. 

When using a switched line to connect a remote 940 EVT or Business System terminal, you must 
connect to the DX10 operating system before bidding SCI. 

When using an RTS terminal, the process is more complex. If your RTS uses switched facilities, 
you must first make the connection to the 990 computer and download the remote terminal soft- 
ware from the 990 computer to the remote device. Exactly how this is done depends on which 
remote terminal you are using. Refer to the Remote Terminal Subsystem (RTS) Operator's Guide. 
The following is a list of the preliminary software procedures required for ICS operation: 

• RTS installation and generation (if used) 

• DX10 operating system installation and generation 

• ICS installation and generation 
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Unless you need to reconfigure your system, perform these steps only once. However, you must 
perform the following operations after each initial program load (IPL): 

• Bidding and logging on to SCI. This procedure is usually required, depending on your 
specific configuration. 



• 



Initializing the DX10 operating system that performs the required LUNO assignments 
and activates the ICS communications line. 



Paragraph 4.2 describes these procedures in more detail, and the DX10 3270 ICS Object Instal- 
lation document provides complete instructions for ICS installation. 



2.5 OPERATING SYSTEM CONCEPTS 

The following paragraphs describe features of the DX10 operating system that ICS uses. These 
paragraphs provide information for those readers not familiar with the DX10 operating system, 
including descriptions of the following items: 

• Device names 

• Pathnames 
Synonyms 
ICS command prompts 



• 



The following paragraphs also describe how the ICS procedures handle your responses to SCI 
command prompts. Paragraph 2.6 provides a complete list of SCI commands unique to ICS instal- 
lation. For further information, refer to the DX10 Operating System Production Operation Manual, 
Volume II. 

2.5.1 System Command Interpreter (SCI) 

SCI is a special task installed on the operating system to handle the interface between you and 
the resources available to the operating system. Several SCI commands are unique to ICS instal- 
lation. You use these SCI commands to control ICS. 

When SCI is bid successfully, the standard installation yields an SCI prompt followed by the cur- 
sor. The SCI prompt is user-defined and typically consists of a pair of brackets, as follows: 

[ ] 

2.5.2 SCI Command Prompts 

When an SCI command is entered at a terminal, a list of command prompts appears on the screen. 
These command prompts indicate the parameters that you can specify to control the execution of 
the command. Several prompts require you to respond by entering an access name. An access 
name can be a device name, a pathname, or a synonym. 



2-10 2250954-9701 



Functional Environment 



2.5.2.1 Device Names. If an access name represents a device, the device name is the name 
assigned to that device during system generation. The device name can be from one through four 
characters in length. The first character must be alphabetic; the others can be alphabetic or 
numeric. The general form for device names is as follows: 

AAxx 

where: 

AA identifies the type of device. 

xx is a decimal number from 01 through 99. 

Table 2-2 describes the commonly used identifiers and what they mean. 

Table 2-2. Device Name Identifiers 

Prefix Meaning 

LP Line printer 

RP Remote line printer 

ST VDTorASR/KSR 

DS Disk device 

CM Communications controller port 



Two decimal numbers follow the prefix. These numbers identify a specific device among those of 
the type indicated by the prefix. For instance, CM01 indicates the first communications controller 
declared during system generation. An ST prefix identifies the 820 KSR data terminal. Although 
this terminal has a keyboard, it is not a video terminal, and ICS cannot use it as such. ICS can use 
it as a printer station. 

2.5.2.2 File Pathnames. The pathname of a file is a concatenation of the volume name, the 
directory levels leading to the file, and the file name itself. Periods separate the components of 
the pathname. The maximum length of a pathname is 48 characters. The volume, directory, and 
file identifiers can each be from one through eight characters in length. The first character must 
be alphabetic, and the others can be alphabetic or numeric. The volume name need not be 
included if the volume is the system disk. A file name can be concatenated directly to a volume 
name without requiring a directory name. 
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Table 2-3 shows examples of valid DX10 pathnames. 



Table 2-3. Pathname Examples 



Pathname 



Description 



VOLN.DIR.FILE 



DS02.DIR.FILE 



.DIR.FILE 



.FILE 



VOLN.FILE 



The pathname of a file identified by FILE, located in direc- 
tory DIR, and located on volume VOLN 

The pathname of a file identified by FILE, located in direc- 
tory DIR, and located on device DS02 

The pathname of a file identified by FILE, located in direc- 
tory DIR, and located on the system disk 

The pathname of a file identified by FILE and located on 
the system disk 

The pathname of a file identified by FILE and located on 
the volume VOLN 



2.5.2.3 Synonym Responses. A synonym is a string of one or more characters that can substi- 
tute for a device name or pathname. When SCI prompts you for a device name or a pathname 
response, you can use a synonym. A synonym can represent an entire pathname or the first com- 
ponents of a pathname. To assign a synonym, use the Assign Synonym (AS) SCI command. See 
the DX10 Operating System Production Operation Manual, Volume II for more information about 
synonyms. 

After you enter a synonym in response to a command prompt, the operating system expands the 
synonym to its assigned value. Synonyms can save keystrokes, which is important to production 
operation. However, synonyms can also provide unexpected results if you are unaware of their 
values. 

Many SCI procedures use synonyms to pass initial values to command prompts. For instance, the 
ICS SCI procedures display a prompt for the communications line name. The first time you 
use one of these procedures at a terminal, no initial value appears for the COMMUNICATIONS 
LINE NAME prompt. The next time you invoke an ICS procedure at the same terminal, the 
COMMUNICATIONS LINE NAME prompt displays (as its initial value) the same value that you 
entered the last time. To use the displayed initial value, press the RETURN key. 
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2.5.2.4 ICS Command Prompts. This paragraph describes how ICS interprets your responses 
to the following command prompts: 

COMMUNICATIONS LINE NAME 

TERMINAL ADDRESS(0- 31) 

PRINT KEY PATHNAME 

• OUTPUT PATHNAME 

For some prompts, ICS does not require a response, and SCI accepts a null value. In those 
instances, ICS uses default values. A null value is a field containing only spaces (blanks). If an ini- 
tial value carried over from a previous execution appears and you press the RETURN key, the ini- 
tial value is accepted. This initial value is not a null value; it is treated the same as if you manually 
entered the response. 

COMMUNICATIONS LINE NAME Prompt. This value identifies the communications line, the 
communications controller port, and the host computer to ICS. You can enter one of the following 
values: 

• A device name of an installed ICS communications controller port. The general form is 
CMxx. 

• A synonym for such a device name. ICS uses the value assigned to the synonym. 

• A null value (sometimes). When ICS accepts a null value, it uses a default value. ICS 
accepts a null value for the line name in the following command procedures: 

— Execute Interactive Communications Controller (XICC) 

— Execute Interactive Communications Printer (XICP) 

— Execute Interactive Communications Terminal (XICT) 

— Execute ICS Program Station Control Task (XPSC) 

If you enter a null value in response to the COMMUNICATIONS LINE NAME prompt when activat- 
ing an ICS video station, printer station, or PSC task, ICS searches the list of installed ICS lines 
and selects the first active line that it finds. ICS lines are ordered within this list in the same 
sequence that you define them when generating the ICS tasks. If two active ICS lines exist and 
you want to activate a station on the second installed line, you must enter the device name of the 
line to select it. 

If you enter a null value in response to the COMMUNICATIONS LINE NAME prompt when activat- 
ing an ICS line, ICS searches the list of installed ICS lines and selects the first inactive line that it 
finds. This is the same ordered list used for auto-selecting the line when activating an ICS video or 
printer station. If you have only one ICS line installed and you enter a null value in response to the 
communications line prompt when activating an ICS line or station, ICS always auto-selects the 
correct line. If the line that ICS auto-selects is already active, ICS displays an error message. 
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Some ICS utility prompts do not accept null values. In these cases, you must enter a valid 
identifier. 

The terminal address is a decimal number in the range of through 31. ICS displays no initial 
value for this prompt. When you enter a null value, ICS selects the terminal address in one of the 
following ways: 

• If ICS has been previously activated at that station but is now suspended, ICS selects 
the terminal address selected during the previous activation. ICS reserves the terminal 
address of a station when it is suspended. 

• If ICS is not in the suspended state at that station, ICS searches a table of terminal 
addresses and selects the first available address of the appropriate type. If all 
addresses are in use, ICS displays a message to that effect. The type is either PRT (for 
printer station addresses) or CRT (for video terminal addresses). 

PRINT KEY PATHNAME Prompt The response to the PRINT KEY PATHNAME prompt deter- 
mines what happens during ICS operation when you press the PRINT key. ICS accepts the follow- 
ing types of responses: 

• Printer device names or print queue names (for example, LP01 or LP$1) 

• File name of a sequential or relative record file 

• Name of any sequential device supported by the operating system other than a 
communications controller port (for example, ST02) 

• DUMY, a specific response that turns off the PRINT key so nothing happens when you 
press it 

• A synonym for any of the preceding responses 

• A null value 

If you specify a valid printer such as LP01, pressing the PRINT key prints the contents of the 
screen at LP01 . If you enter a valid pathname, then press the PRINT key, ICS writes the contents of 
the screen to the file specified by the pathname. 

You should use LP$1 rather than LP01 as the PRINT key pathname. If an ICS video station tries to 
print to LP01 while another ICS video station is already printing the contents of its screen at LP01 , 
ICS cannot access the printer and returns an error message. This error does not affect the print in 
progress. 

If you select a valid pathname, ICS writes the contents of the screen to the file specified by that 
pathname. If that file does not already exist, ICS creates it automatically, provided that the direc- 
tory where it is to reside exists and is not full. If the file already exists, ICS appends the contents 
of the screen to the existing file each time you press the PRINT key. ICS supports sequential and 
relative record files. 
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To change the PRINT key pathname during ICS operation, perform the identification function 
(paragraph 3.4.4.8). 

ICS displays no initial value for the PRINT KEY PATHNAME prompt. If you enter a null value, ICS 
uses the default value. The default value for the PRINT KEY PATHNAME prompt is defined by ter- 
minal address. The default value for this prompt is the value last specified for the terminal address 
you use. ICS accepts and evaluates synonyms for this field. Once you assign a value to the PRINT 
key pathname, that value becomes the default value for this prompt for subsequent activations of 
the terminal address that you use. To obtain the current value for each terminal address, perform 
the List Interactive Communications Configuration (LICC) command. 

OUTPUT PATHNAME Prompt The response to the OUTPUT PATHNAME prompt identifies the 
device or file that ICS uses as the ICS printer station. ICS accepts the following types of 
responses: 



• 



Printer device names or print queue names (for example, LP$1 or LP01) 

• File name of a sequential or relative record file 

• Name of any sequential device supported by the operating system other than a commu- 
nications controller port (for example, ST02) 

• A synonym for any of the preceding responses 

The response to the OUTPUT PATHNAME prompt can be any of the responses that ICS accepts as 
the PRINT KEY PATHNAME prompt. Usually, the output pathname is designated as a file. If you 
specify a printer device, use the LP$x form rather than the LPxx form. The LP$x form is the print 
queue access name. Using the LP$x form can prevent errors and make more efficient use of the 
printers. ICS provides no initial value for this field. If you enter a null value, ICS uses the default 
value. For the first execution, the default value is the value declared during installation. Once a 
new value is assigned to the OUTPUT PATHNAME prompt, it becomes the default value for subse- 
quent activations of the terminal address you use. ICS does not display it as an initial value, how- 
ever. You can obtain the current default value for this prompt by performing the List Interactive 
Communications Configuration (LICC) command. Refer to Section 4. 

If you enter a file name, ICS writes the output to the file specified. If the file specified does not 
already exist, ICS creates it, provided that the directory where it is to reside exists and is not full. If 
the file already exists, ICS appends the data received from the host to the existing file. 

The local format file stores data received from the host when no ICS station is active. If you do not 
select the local format file option during installation, ICS accepts transmissions from the host 
only when a station is active. 
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2.6 SCI COMMANDS UNIQUE TO ICS 

This paragraph lists ail the ICS-specific System Command Interpreter (SCI) command procedures 
available on a DX10 operating system that has ICS installed. These procedures are not part of the 
standard operating system butare incorporated when ICS is installed. The commands and their 
functions are listed, and the specific paragraphs that detail the procedures are referenced, as 
follows: 

Execute Interactive Communications Controller (XICC) — Activates an ICS 
communications line. Refer to paragraph 4.2.2. 

Execute Interactive Communications Printer (XICP) — Activates an ICS printer station. 
Refer to paragraph 3.2.2. 

Execute Interactive Communications Terminal (XICT) — Activates a specific ICS display 
station. Refer to paragraph 3.2.1 . 

Execute Poll Analyzer (XPA) — Provides a listing of buffer activity for the systems 
analyst. See paragraph 4.5. 

Execute Programmed Station Control Task (XPSC) — Activates a user-written program 
that acts in place of an ICS station. Refer to paragraph 5.7. 

List Interactive Communications Configuration (LICC) — Displays the current 
installation configuration for a specific communications line name. Refer to paragraph 
4.3.1. 

List Interactive Communications Statistics (LICS) — Displays statistical information 
about an individual ICS line. Refer to paragraph 4.4. 

Modify ICS Control Unit Address (MCUA) — Changes the control unit address of an 
inactive ICS line. Refer to paragraph 4.3.3. 

Modify Interactive Communications Configuration (MICC) — Changes the state 
(enabled/disabled) and the type (CRT or PRT) of a particular terminal address. Refer to 
paragraph 4.3.2. 

Patch ICS PSC User Task (PTPSC) — Applies the latest patches to the PSC Emulator 
routines that are linked to the user-written PSC task. Refer to paragraph 5.6. 

Quit Interactive Communications Terminal (QICT) — Terminates a particular ICS display 
or printer station. Refer to paragraph 3.3.2.1 . 

For quick reference when using the DX10 operating system, ICS provides a menu that lists all 
these commands. To display this menu at a video terminal, enter the following characters in 
response to the SCI prompt: 

/ICS 

Figure 2-4 shows the ICS menu. 
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Figure 2-4. ICSMenu 
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3.1 INTRODUCTION 

This section describes how to operate both the display and printer stations of the DX10 3270 Inter- 
active Communications Software (ICS). It assumes that all of the preliminary steps listed in Sec- 
tion 2 have been successfully completed. It tells the operator how to activate and terminate an ICS 
station and how to enter and send data. This section covers the operation of the ICS-supported 
video terminals, which are referenced individually only in those cases in which they operate differ- 
ently. Printer operation and error reporting are also detailed. This section describes the System 
Command Interpreter (SCI) commands that are designed for the data entry operators use. 

ICS allows any ICS-supported video terminal to emulate the operation of IBM Model 2 3277 and 
3278 Display Stations. The ICS display station communicates with application programs execut- 
ing at the host system. An application program can transmit a display to the ICS video station or 
require the ICS video station operator to enter data and transmit it to the host. When the host 
transmits a display to your station, the display can be formatted or unformatted and can appear 
with or without data. Then you take one of the following actions: 

• Read the data presented (inquiry-only applications) 

• Edit the data displayed on the ICS display station 

• Enter data 

Any edited or entered data can then be transmitted to the application program. Data displays are 
transferred back and forth between the application program and your ICS video station until the 
data exchange is complete. 

ICS allows any DX10-supported printer or file storage device to emulate the operation of IBM 
Model 2 3284, 3286, and 3287 Printer Stations. Printer stations only receive data. ICS translates the 
format-control characters transmitted by the host and either passes them to a printer for a hard 
copy or writes them onto a file. 



3.2 ACTIVATING AN ICS STATION 

The following paragraphs describe how to activate an ICS station using SCI. The two SCI com- 
mands to use are Execute Interactive Communications Terminal (XICT) and Execute Interactive 
Communications Printer (XICP). The XICT Command activates an ICS video station (type CRT), 
while the XICP activates an ICS printer station (type PRT). Messages associated with the use of 
these commands are also described. 
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3.2.1 Execute Interactive Communications Terminal — XICT 

To activate ICS at any of the supported video terminals, enter XICT in response to the SCI prompt. 
The following appears on the screen: 

C ] XICT 

EXECUTE INTERACTIVE COMMUNICATIONS TERMINAL 
COMMUNICATIONS LINE NAME: 
TERMINAL ADDRESSCO-31 ) : 
PRINT KEY PATHNAME: 
UNPROTECTED FIELD INDICATOR?: YES 

3.2.1.1 COMMUNICATIONS LINE NAME Prompt. Your response to the COMMUNICATIONS 
LINE NAME prompt identifies to ICS which communications line to use for the communications 
session. Because only one host can be configured per communications line, this response also 
identifies the host with which ICS is to communicate. This value has a control unit address 
assigned to it during ICS installation. You must activate the communications line you specify 
prior to activating a specific station. Paragraph 4.2.2 explains how to activate an ICS line. 

Valid line identifiers can be device names of communications controllers or synonyms for such 
device names. 

ICS does not require a response for the COMMUNICATIONS LINE NAME prompt. If you enter a 
null value, ICS searches a list of the currently active communications lines and selects the active 
line that is first declared during ICS installation. Paragraph 2.5.2.4 describes how this auto-select 
works. 

3.2.1.2 TERMINAL ADDRESS (O - 31) Prompt. ICS does not require a response to this prompt. 
If you enter a null value, ICS selects the terminal address. If ICS is suspended at that terminal, ICS 
uses the address already reserved for that terminal. Otherwise, ICS searches a list of installed 
terminal addresses for one that is idle and is of the CRT (video) type. ICS assigns the first available 
address to the ICS station for the duration of the communications session. If all the installed ter- 
minal addresses of the CRT type are in use, ICS displays an error message and does not activate 
the station. Paragraph 2.5.2.4 details how the auto-select works. 

You can specify a particular terminal address. The address you specify must satisfy the following 
conditions: 

• It must be the CRT (video) type. 

• It must not be currently assigned to another station. 

• It must have been reserved during ICS installation. 

• It must not be disabled. 

3.2.1.3 PRINT KEY PATHNAME Prompt. Your response to the PRINT KEY PATHNAME prompt 
determines what happens during ICS operation when you press the PRINT key. If you enter a valid 
printer device name such as LP01, then press the PRINT key, ICS prints the contents of the screen 
at LP01. If you enter a valid pathname, then press the PRINT key, ICS writes the contents of the 
screen to the file specified by the pathname. 
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Your response to the PRINT KEY PATHNAME prompt can be any of the following: 

• Printer device name or print queue name (for example, LP01 or LP$1) 

• File name of a sequential or relative record file 

• Name of any sequential device other than a communications controller port (for 
example, ST02) 

• DUMY, a specific response that turns off the PRINT key so that nothing happens when 
you press it 

To prevent unnecessary errors, you should use LP$1 ratherthan LP01 as the PRINT key pathname. 
If an ICS video station tries to print to LP01 while another ICS video station is already printing the 
contents of its screen at LP01, ICS cannot access the printer and returns an error message. This 
error does not affect the print in progress. The LP$x form is valid for all printers from LP$1 through 
LP$9. See paragraph 4.2 for further information about this form of device specification. 

If you enter a valid pathname, then press the Print key, ICS writes the contents of the screen to the 
file specified by that pathname If that file does not already exist, ICS creates it automatically, 
provided the directory in which it is to reside exists and is not full. If the file already exists, ICS 
appends the contents of the screen to the data already in the file. 

ICS provides no initial value for this prompt. If you enter a null value, ICS uses the default value for 
the PRINT key pathname. The default value is the value that was specified the last time that any 
ICS station activated the terminal address that you are now activating. If the terminal address has 
not been activated since the initial program load (IPL), the default value is the value specified dur- 
ing ICS installation. 

You can change the PRINT key pathname during ICS operation by performing the identification 
function as described in paragraph 3.4.4.8. 

3.2.1.4 UNPROTECTED FIELD INDICATOR Prompt. An unprotected field indicator is a special 
graphics character that ICS uses to mark the beginning of an unprotected field on the screen. You 
can enter or erase data only when the cursor is in an unprotected field. The character marking the 
beginning of a field is called the attribute character. Attribute characters cannot be overwritten or 
erased. If you respond with YES to the UNPROTECTED FIELD INDICATOR prompt, ICS displays 
each attribute character that marks the beginning of an unprotected field. This shows you where 
you can modify the screen. The initial value for this prompt is YES. When you accept this value (or 
enter YES on the keyboard), ICS displays the special graphics character shown in Figure 3-1 
immediately to the left of the beginning of every unprotected field on the screen. 



NOTE 

Some early versions of 911 and 915 terminals do not include graph- 
ics support. If your terminal does not support these graphics char- 
acters, the unprotected field indicator still appears as a lighted 
rectangle except that it is larger than that shown in Figure 3-1 and it 
looks like a cursor displayed in low intensity. 
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Figure 3-1. Unprotected Field indicator 



If you position the cursor immediately to the right of any of these characters, the cursor does not 
blink, indicating that ICS accepts your data entries or erasures. If you position the cursor within a 
protected field, the cursor blinks. If you press a data or erase key while the cursor is in a protected 
field, the audible alarm sounds. If you respond NO to the UNPROTECTED FIELD INDICATOR 
prompt, ICS displays all attribute characters, including unprotected field attribute characters as 
blanks. The only responses that ICS accepts to the UNPROTECTED FIELD INDICATOR prompt are 
as follows: 

• YES — Uppercase only 

• Y — Short for yes, uppercase only 

• NO — Uppercase only 

• N — Short for no, uppercase only 

3.2.1.5 Examples of ICS Video Terminal Activation. This paragraph shows two examples of ICS 
video terminal activation. In the first example, you enter CM02 in response to the 
COMMUNICATIONS LINE NAME prompt. The terminal address is not entered, and ICS selects one 
automatically. Refer to paragraph 2.5.2.4. The response to the PRINT KEY PATHNAME prompt is 
LP$3, indicating that when you press the PRINT key, ICS queues the contents of the screen to the 
LP03 print queue. When LP03 becomes available, the print begins. ICS accepts the initial value for 
the UNPROTECTED FIELD INDICATOR prompt, YES. 

EXAMPLE 1 

[ ] XICT 



EXECUTE INTERACTIVE COMMUNICATIONS 
COMMUNICATIONS LINE NAME: CM02 
TERMINAL ADDRESS (0-31 ) : 

PRINT KEY PATHNAME: LP $3 
UNPROTECTED FIELD INDICATOR?: YES 



TERMINAL 
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In the second example, you enter only the terminal address. ICS uses the first installed ICS line 
that is currently active for the communications line name and accepts the initial values provided 
for the PRINT KEY PATHNAME prompt (LP$1) and the UNPROTECTED FIELD INDICATOR prompt 
(YES). 

EXAMPLE 2 

[ ] XICT 

EXECUTE INTERACTIVE COMMUNICATIONS TERMINAL 
COMMUNICATIONS LINE NAME: 
TERMINAL ADDRESS (0-31 ) : 5 

PRINT KEY PATHNAME: LP$1 
UNPROTECTED FIELD INDICATOR?: YES 

3.2.1.6 Verifying Video Terminal Activation. If the activation is successful, the cursor appears 
in the upper left corner of the screen. The rest of the screen is blank unless the ICS station was 
suspended prior to activation. When you activate a suspended station, the screen appears exactly 
as it did prior to suspension. 

If an error occurs, ICS clears the screen and writes an error message on the bottom line. Parts of 
these messages are variables whose content depends on your responses to ICS command 
prompts. The following list shows typical error messages generated by an unsuccessful attempt 
to activate an ICS station: 

•XICT-CM01 IS NOT AN ICS COMMUNICATIONS LINE: 

*XICT-HIGHEST TERMINAL ADDRESS IS 06: 

•XICT-TERMINAL ADDRESS 02 BELONGS TO A PRINTER: 

*XICT-ALL ICS VIDEO ADDRESSES ARE IN USE: 

*XICT-CM01 HAS NOT BEEN ACTIVATED BY "XICC": 

*XICT-INVALID PRINTER PATHNAME LP12: 

See Appendix B for an explanation of these and other messages, the source of the variable parts, 
and the recommended corrective action. 

3.2.2 Execute interactive Communications Printer — XICP 

An ICS printer station can either print data from an ICS line or copy the data onto a file or sequen- 
tial device. To activate an ICS printer station, enter XICP in response to the SCI prompt. ICS 
displays the following prompts: 

[ ] XICP 

EXECUTE INTERACTIVE COMMUNICATIONS PRINTER 
COMMUNICATIONS LINE NAME 
TERMINAL ADDRESS (0-31 ) 
OUTPUT PATHNAME 
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3.2.2.1 COMMUNICATIONS LINE NAME Prompt. Your response to the COMMUNICATIONS 
LINE NAME prompt identifies to ICS which communications line to use for the communications 
session. Since only one host can be configured per communications line, this response also iden- 
tifies the host with which ICS is to communicate. This value has a control unit address assigned 
to it during ICS installation. The communications line that you specifiy must already be active. 
Paragraph 4.2.2 explains how to activate an ICS line. 

Valid line identifiers can be device names of communications controller ports or synonyms for 
such device names. 

ICS does not require a response to the COMMUNICATIONS LINE NAME prompt. If you enter a null 
value, ICS searches a list of the currently active communications lines and selects the active line 
that was first declared during ICS installation. 

3.2.2.2 TERMINAL ADDRESS (0 - 31) Prompt. The TERMINAL ADDRESS (0-31) prompt allows 
you to specify a specific terminal address. If you enter a null value in response to this prompt, ICS 
assigns the first available terminal address of the PRT (printer) type. The address you specify must 
satisfy the following conditions: 

• It must be the PRT (printer) type. 

• It must not be currently assigned to another station. 

• It must have been reserved during ICS installation. 

• It must not be disabled. 

3.2.2.3 OUTPUT PATHNAME Prompt. The response to the OUTPUT PATHNAME prompt can be 
any of the following identifiers: 



• 



Printer device name or print queue name (for example, LP01 or LP$1) 

• File name of a sequential or relative record file 

• Name of any sequential device other than a communications controller port (for 
example, ST02) 

If you specify a printer device, use the LP$x form rather than the LPxx form. If you specify LP01 
when LP01 is printing another job, ICS cannot access LP01 and displays an error message. If LP01 
is not busy when you select it as the output pathname, ICS prints the output as specified. ICS 
does not allow any other application to access LP01 until you terminate the printer station by 
using the Quit Interactive Communications Terminal (QICT) command. Refer to paragraph 3.3.2.1 
for a description of the QICT command. If another user tries to print a file at LP01 while ICS has 
exclusive access to it, SCI reports no errors and shows that LP01 is actively printing. LP01 cannot 
begin printing the request until ICS releases LP01. ICS does not release any printer specified in 
the LPxx form until you terminate the ICS printer station. 
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If you specify LP$1 when LP01 is busy, ICS places the data in a print file queue. LP01 prints each 
queued file on a first-in, first-out basis. This means that other applications can share LP01 with 
ICS. Using the print file queue may take slightly longer, but you can avoid some errors this way 
and make more effective use of the printers. 

If you enter a file name, ICS writes the data to the specified file. If the file specified does not 
already exist, ICS creates it, provided the directory in which it is to reside exists and is not full. If 
the file already exists, ICS appends the new data after the data that is already in the file. 

If you enter a null value, ICS assigns the default value as the output pathname. For the initial exe- 
cution of this command, the default value is the value declared during installation. For subse- 
quent executions, ICS uses the value assigned during the previous execution as the default value. 

3.2.2.4 Examples of ICS Printer Station Activation. This paragraph shows two examples of ICS 
printer station activation. In the first example, you specify CM02 as the communications line 
name. You specify no value for the terminal address, so ICS selects one. You enter LP$1, so the 
data is queued at LP01 and printed in turn. 

EXAMPLE 1 

[ ] XICP 

EXECUTE INTERACTIVE COMMUNICATIONS PRINTER 
COMMUNICATIONS LINE NAME: CM02 
TERMINAL ADDRESS (0-31) : 

OUTPUT PATHNAME: LP$1 

The next example shows no values entered for the COMMUNICATIONS LINE NAME or TERMINAL 
ADDRESS prompt, so ICS selects these values. ICS writes the data to the file named FILE residing 
under the directory DIR which is on the volume VOL. 

EXAMPLE 2 

[ ] XICP 

EXECUTE INTERACTIVE COMMUNICATIONS PRINTER 
COMMUNICATIONS LINE NAME: 
TERMINAL ADDRES S ( 0-3 1 ) : 

OUTPUT PATHNAME: VOL. DIR. FILE 

3.2.2.5 Verifying Printer Station Activation. If ICS detects any errors, it displays an error mes- 
sage and does not perform the activation. Determine the problem, correct it, and reenter the com- 
mand. If ICS reports no errors, you can assume that output has been properly directed to the 
designated device. If you enter a null value in response to the TERMINAL ADDRESS(0-31) 
prompt, ICS selects the terminal address and displays the following type of message at your 
terminal: 

•XICP- TERMINAL ADDRESS xx ON COMMUNICATIONS LINE yy ACTIVATED: 
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The following list shows error messages commonly generated during an unsuccessful activation 
attempt: 

*XICP-CM01 IS NOT AN ICS COMMUNICATIONS LINE: 

•XICP-HIGHEST TERMINAL ADDRESS IS 06: 

•XICP-TERMINAL ADDRESS 02 BELONGS TO A VIDEO TERMINAL: 

*XICP-ALL ICS PRINTER ADDRESSES ARE IN USE: 

*XICP-CM01 HAS NOT BEEN ACTIVATED BY "XICC": 

*XICP-INVALID PRINTER PATHNAME LP12: 

See Appendix B for an explanation of these and other messages, the source of the variable parts, 
and the recommended corrective action. 

If the printer is out of paper, offline, or in need of a new ribbon (for a letter-quality printer), ICS can- 
not successfully print the data. In these instances, ICS allows you up to 30 minutes to correct the 
error condition. This time-out value can be modified. Refer to paragraph 4.8.4. If you do not correct 
the error condition within 30 minutes, ICS writes a message to the system log file and writes the 
current buffer to a local format file. This makes retransmission unnecessary. This command 
always examines the local format file and prints any existing data before it services any new data 
arriving from the host. If you do not select the local format file option during installation, no data 
is saved. 

3.3 EXITING ICS 

When an ICS station is activated, control of the station passes to ICS. You can suspend an ICS 
video station without terminating it. You can terminate any active or suspended ICS station with 
the Quit Interactive Communications Terminal (QICT) command. You can also terminate an ICS 
video station directly. Exactly which keystrokes accomplish these actions depends on the 
terminal being used. 

3.3.1 Suspending ICS 

You can suspend ICS at a video station after it has been activated by pressing the command key. 
To find the Command key for your terminal, refer to Appendix A. Once you suspend ICS, you must 
reactivate the station by entering XICT before you can use it again. Suspending ICS at a station 
does not release the terminal address allocated during activation. The screen present at the time 
of suspension is saved along with the cursor position and whatever data had been entered 
(provided that you selected the local format option when installing ICS). When reactivated, the 
screen appears exactly as it did at the time of suspension. 

You cannot suspend ICS printer stations. You can only terminate them. 
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If you enter no value for the terminal address when you are reactivating ICS at a suspended sta- 
tion, ICS uses the terminal address that is still reserved for that station. If you enter a value for 
terminal address when reactivating, ICS allocates the additional address, if possible. This pro- 
cess is useful when an ordinary transaction is interrupted to process a priority order. The partially 
complete contents of the routine transaction can be saved by using another terminal address. 
This is usually unnecessary and uses two terminal addresses when only one is required. 

When you suspend ICS, SCI returns. The default menu for SCI, the SCI prompt, and the cursor 
(immediately to the right of the prompt) appear on the screen. Once SCI returns, you can execute 
any of the utilities available from the operating system. When you wish to reactivate your video 
station, enter the following characters: 

[ ] XICT/ 

When you initially activated the station, you supplied all the necessary values in response to each 
prompt. The slash ( / ) after XICT is an SCI primitive command that allows you to use the initial val- 
ues without pressing the Return key for each prompt. In this instance, after you enter XICT/ and 
press the RETURN key once, SCI uses the same values that you entered initially and activates ICS 
without stopping the cursor at each prompt. 

3.3.2 Terminating ICS 

You can terminate an active ICS display station in two ways. If SCI is present, execute the QICT 
command procedure. If ICS is active at the station, use the terminate function keys. Refer to para- 
graph 3.3.2.2. You can also terminate an active ICS printer station using the QICT command pro- 
cedure. Terminating an ICS station releases the terminal address for use by another station. 

3.3.2.1 Quit Interactive Communications Terminal — QICT. The QICT command can terminate 
any active ICS station. To terminate either an ICS printer or video terminal communications ses- 
sion, enter QICT in response to the SCI prompt. The following prompts appear on the screen: 

C ] QICT 

QUIT INTERACTIVE COMMUNICATIONS TERMINAL 

COMMUNICATIONS LINE NAME: 

TERMINAL ADDRESS (0-31 ) : 

TERMINAL TYPE ( C RT/PRT) : 

TERMINAL PATHNAME: 

The communications line name is the same value specified during activation. Usually, the initial 
value supplied for this prompt is the one you use. The only time you may need to use a value other 
than the one supplied is when two ICS lines are installed and you use both of them at your ter- 
minal. In any case, you must enter a valid communications line name in response to this prompt. 
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You must respond to the TERMINAL ADDRESS(0-31) prompt when more than one terminal 
address is assigned to the station designated by the TERMINAL PATHNAME prompt. If you spec- 
ify the terminal address, you do not have to specify the terminal pathname. The initial value for the 
TERMINAL TYPE prompt is CRT, which specifies an ICS video station. When terminating an ICS 
printer station, change this to PRT. 

The initial value of the TERMINAL PATHNAME prompt is the device name of the station at which 
you entered QICT. Specify either the terminal device name (or a synonym) or the terminal address. 
Both are not required unless more than one terminal address is assigned to the terminal specified. 
You may specify both. If ICS determines that the terminal name you entered does not have the 
specified terminal address assigned to it, ICS displays an error message and takes no further 
action. 

When you terminate ICS using the QICT command, ICS displays a configuration listing on the 
screen. SCI returns, displaying the SCI prompt and cursor on the bottom line. Refer to paragraph 
4.3.1. 

In the following example, an operator at ST01 (a display terminal) terminates the ICS station active 
at ST05. 

EXAMPLE 1 

[ ] QICT 

QUIT INTERACTIVE COMMUNICATIONS TERMINAL 
COMMUNICATIONS LINE NAME: CM02 
TERMINAL ADDRESS (0-3 1 ) : 
TERMINAL TYPE ( CRT/ PRT) : CRT 
TERMINAL PATHNAME: ST05 

If only one terminal address is assigned to ST05, ICS terminates at ST05, clears the screen there, 
and displays a configuration listing: 

*XICT-TERMINATED BY ANOTHER USER 

If for any reason the termination is unsuccessful, ICS displays a message at the terminal at which 
you entered QICT. For instance, if ST05 is not an active (or suspended) ICS station, the following 
message appears at ST01 : 

*QICT-ICS NOT RUNNING AT..ST05: 
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The following example demonstrates how to terminate an ICS printer station. . 

EXAMPLE 2 

C ] QICT 

QUIT INTERACTIVE COMMUNICATIONS TERMINAL 
COMMUNICATIONS LINE NAME: CM02 
TERMINAL ADDRES S ( 0-31) : 
TERMINAL T Y PE ( C RT / PRT) : PJLL 
TERMINAL PATHNAME: LP$2 

If the termination is successful, ICS displays a configuration listing at your terminal which shows 
the printer terminal address as inactive. If for any reason the termination is unsuccessful, a mes- 
sage appears at your terminal. For instance, if two terminal addresses are assigned to LP02, the 
following message appears at the terminal where you entered QICT: 

•QICT-TERMINAL ADDRESS NEEDED: 

When two terminal addresses are assigned to one ICS device, you must specify the terminal 
address. When you specify the terminal address, you need not specify the terminal pathname. 

Under normal operation, when only one terminal address is assigned to your ICS video station, 
you can use the SCI primitive form with QICT to terminate your station, as follows: 

[ 3 QICT/ 

The slash ( / ) specifies that SCI uses the initial values assigned to the prompts without stopping 
the cursor at each prompt. When you press the RETURN key, SCI terminates the ICS video station, 
except when more than one terminal address is assigned to your station or if you have deleted or 
modified your synonyms. 

3.3.2.2 Terminating iCS at an Active Station. To terminate ICS at an active ICS video station, 
press the extended function key, release it, then press Q. You can locate the extended function 
key (Exit key) for your terminal by referring to Appendix A in this manual for more information. 

When you press the extended function key, the cursor blinks without moving. This indicates that 
ICS is waiting for you to press another key. If you press the extended function key again (instead 
of Q), the cursor stops blinking and your station remains active. When you press the second key 
(Q), ICS terminates and clears the screen. 
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NOTE 

Throughout this manual, the notation in the format < extended func- 
tion key> + N(Exit + n) indicates that you press and release the Exit 
key, then press the key indicated by n. You do not actually enter the 
plus sign ( + ) that immediately follows Exit. In all cases where the 
< extended function key> is the first key and an alphabetic key is 
the second key, the alphabetic key performs the desired function 
whether it is uppercase or lowercase. For example, < extended 
function key> + Q is functionally equivalent to < extended function 
key> +q. Finally, the notation in the format (x)y indicates that you 
press and hold the key indicated by x, then press the key indicated 
by y. For instance, (SHIFT)ALT indicates that you press and hold the 
shift key, then press the ALT key. Where a key is labeled with two 
characters (such as 1 and !) and perform the same as a standard 
typewriter key, this manual omits this notation. For instance, ! rep- 
resents the exclamation point, rather than (SHIFT)1 . 

When you terminate ICS using the < extended function key> +Q 
sequence, ICS clears the local format file. When you reactivate a 
terminal address that was terminated by this key sequence, the 
screen is blank. 



3.4 VIDEO DISPLAY TERMINAL OPERATION 

The following paragraphs describe the operation of the video terminals as ICS stations. Note that 
the description that follows is valid only when ICS controls the station. When other applications 
control these devices, the keyboard can function differently. 

These paragraphs also describe the displays, data entry, special functions, and program attention 
keys. 

3.4.1 Keyboard Layout 

ICS-supported video terminals are interactive display terminals with keyboards. These keyboards 
have the following groups of keys: 

• Alphanumeric typewriter keyboard 

• Numeric pad 

• Cursor control and edit key pad 

• Function keys 
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ICS terminals emulate every key on the IBM 3277 typewriter keyboard, except the TEST REQ key. 
Some of the 3277 keys are emulated by two-key functions on ICS terminals, and some are labeled 
differently. Table 3-1 lists all the keys that are identical on ICS and IBM 3277 keyboards. Some of 
these keys may be located in a different position, but they perform the same function and are 
labeled the same. 



Table 3-1. Identical ICS/3277 Keys 



Key(s) 



Description 



Key(s) 



Description 



A-Z 


Alphabetic 


0-9 


Numeric 


SHIFT 


Shift 




Cursor up 




Cursor down 




Cursor right 




Cursor left 


ERASE INPUT 


Erase input 


ENTER 


Send to host 




At sign 




Pound sign 


$ 


Dollar sign 


% 


Percent sign 


& 


Ampersand 


* 


Asterisk 


( 


Left parenthesis 


) 


Right parenthesis 



Space bar 



Plus sign 

Exclamation point 

Hyphen 

Equal sign 

Underscore 

Semicolon 

Colon 

Quotation mark 

Apostrophe 

Less-than sign 

Comma 

Greater-than sign 

Period 

Question mark 

Slash 

Blank 
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Table 3-2 lists single keys that perform the same functions but are labeled differently. 



Table 3-2. ICS/3277 Single Key Equivalents 



IBM 3277 
Key(s) 



Generic 
Key(s) 



Key Function 



CLEAR 


Initialize Input 


ENTER 


Enter 


LOCK 


Uppercase Lock 




Next Field 




Previous Field 




Return 


INS MODE 


Insert Character 


DEL 


Delete Character 


PF1-PF8 


F1-F8 


(vertical bar) 


] 


] (logical not) 


A 


(cent sign) 


[ 



Clear screen 

Send to host 

Uppercase alphabetic 

Field right 

Field left 

New line 

Insert character 

Delete character 

Program function 
1 through 8 

Right bracket 

Caret 

Left bracket 



ICS emulates several IBM 3277 typewriter keys by using a two-key sequence. Table 3-3 lists these 
IBM keys and the two-key ICS equivalent. The first key in each sequence is the extended function 
or Exit key. Extended function key is called Exit in Appendix A. Refer to Appendix A in this manual 
for the location of the extended function key (Exit key) for your particular terminal. When you press 
the extended function key, the cursor does not move but begins to blink, indicating that ICS is 
waiting for you to press another key. If you press the extended function key again, the cursor 
stops blinking, and you can continue to enter data or edit the contents of the screen. 
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Table 3-3. ICS Two-Key Sequences That Emulate a 3277 Key 



3277 
Key(s) 



Generic Key 
Sequence(s) 



Function 



ALPHA 



Exit + A 



DUP 


Exit+D 


FLDMARK 


Exit + F 


IDENT 


Exit + 1 


PA1 


Exit+ + 




(plus) 


PA2 


Exit+ - 




(hyphen) 


PA3 


Exit + 




(underscore) 


PF1 


Exit + 01 


through 


through 


PF12 


Exit + 12 


RESET 


Exit + R 



Allows the entry of nonnumeric 
input into numeric fields 

Duplicate previous field (remote) 

Field mark 

Identification 

Program access key 1 

Program access key 2 

Program access key 3 

Program function keys 



Reset keyboard 



Notes: 

1 This key sequence on a 940EVT is (ALT)P1 

2 This key sequence on a 940EVT is (ALT)P2 

3 This key sequence on a 940EVT is (ALT)P3 

4 This key sequence on a 940EVT is F1 through F12 



ICS performs several functions not supported by IBM 3277 typewriter keyboards. Table 3-4 shows 
ICS key functions that have no IBM equivalent. 
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Table 3-4. ICS Keys Without IBM 3277 Equivalents 



Generic Key 
Sequence(s) 



Function 



Command 
Exit + E 
Exit + L 
Exit + M 

Exit + P 

Exit + Q 

Exit + 13 
through 
Exit + 24 

Exit + Exit 

Erase Field 

Home 

Print 

Print + Print 

Repeat 

Skip 



Tab 



CMD Suspend ICS station 

Erase to end-of-screen (EOS) 

Locally duplicate previous field 

Switch tab mode TABS 
and WORD mode 

Append the cursor to the end 
of a word 

Terminate ICS video station 

Program function keys PF13 through 
PF24 (these are 3278 keys) 

Cancel extended function mode 

Erase entire field (including 
data to the left of the cursor) 

Cursor to the first character 
position 

Print screen 

Cancel print 

Emulates an extension of the 
IBM typamatic feature 

Erase to the end-of-f ield 
and tab (can optionally 
switched with TAB) 

Tabs according to field, 
depending on the tab 
mode (can optionally be 
switched with Skip) 



Notes: 

1 The key sequence on a 940EVT is F1 3 through F24 

2 Data and cursor control keys are typamatic 



3-16 



2250954-9701 



ICS Station Operation 



3.4.2 Displays 

After ICS is activated and the ICS display station is interacting with the host application pro- 
gram^), a display, ready for editing or data entry, appears on the screen. The display can be for- 
matted or unformatted. A formatted display is organized into fields; an unformatted display has 
no fields. 

You should be familiar with the operating instructions of the application before altering the 
display. 

The data for display is stored in a 1920-character buffer and is displayed in 24 lines of 80 charac- 
ters each. Each buffer location is referenced by its buffer address. The buffer is addressed from 
(the upper left corner character position) through 1919 (the bottom right corner character 
position). The character positions on the display have a direct relationship to the buffer positions. 
The data you enter on the keyboard updates the buffer and is displayed as it is entered. 

These video terminals display both uppercase and lowercase letters. Under ICS control, these 
terminals support the 89-character EBCDIC character set shown in Appendix D. 

3.4.2.1 Formatted Displays. A formatted display is divided into fields. The host application 
program defines each field with an attribute character. The attribute character determines the 
characteristics of the field. Usually, an attribute character appears as a blank preceding the first 
character position of a field. ICS provides the option of displaying attribute characters that mark 
the beginning of unprotected fields. Refer to paragraph 3.2.1.4. The attribute character can define 
a field in the following ways: 

• Protected or unprotected. You cannot enter or erase data when the cursor is located in a 
protected field. You can modify an unprotected field. ICS optionally provides the display 
of a special graphics character to mark the beginning of unprotected fields. 

• Alphanumeric or numeric. You can enter alphabetic, numeric, or special characters in 
an alphanumeric field. Numeric fields are reserved for numeric input and accept only 
the following characters: 

— through 9 

— The minus sign (-) 

— The decimal point ( . ). The comma replaces the decimal point on some inter- 
national keyboards. 

• Display, nondisplay, or highlighted display. This characteristic determines whether the 
fields are displayed and, if so, specifies high-intensity or low-intensity display. 

• Modified or unmodified. This characteristic determines whether the the ICS display 
station operator or host application program has modified the field. This is the only attri- 
bute characteristic that is changed by operator input. Editing or entering data into an 
unprotected field automatically changes the attribute character for that field from 
unmodified to modified. 
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Fields can wrap from one line to the next or even from the bottom line to the top, as shown in 
Figure 3-2. Fields are ordered according to the positions of their attribute characters on the 
screen. Even though part of field 3 wraps to the top line, it is not the first field on the screen since 
its attribute character appears after those of fields 1 and 2. 

You cannot enter data over an attribute character. The cursor begins to blink when you position it 
on an attribute character. If you press any of the keys used for data entry or erasure, ICS does not 
perform the function. To enter or erase data, move the cursor to an unprotected field. 

3.4.2.2 Unformatted Displays. With an unformatted screen, you use the keyboard to edit exist- 
ing data or to enter new data without the restrictions imposed by defined fields. An unformatted 
display contains no attribute characters. You should assume that the characteristics of the dis- 
play are unprotected, alphanumeric, and display. ICS treats an unformatted display as one large 
field. 




in. 

222, 

333. 



2281463 



1 1 1 FIELD I 
222 FIELD 2 
FIELD 3 
ATTRIBUTE 
CURSOR 



.333 

@ 




Figure 3-2. Display Screen Format 
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3.4.2.3 Cursor. The cursor appears as a lighted rectangle that occupies a character position 
on the screen. The cursor can share a character position with a character. The data sharing a char- 
acter position with the cursor is not erased but is displayed in reverse video (silhouetted) to indi- 
cate cursor location. The position of the cursor indicates where the next entered character is 
displayed. 

Typically, the cursor is initially positioned in the first position of the first unprotected field of a 
formatted screen or in the upper left corner of an unformatted screen. 

Normal movement of the cursor on the display is continuous from left to right and from top to bot- 
tom. The cursor wraps from the bottom of the screen to the top of the screen. The alphanumeric 
keys on the keyboard move the cursor one character position at a time from left to right. Special 
keys move the cursor without changing any data on the display. The cursor movement for these 
special keys is described later in this section. 

Certain ICS functions require a two-key sequence. The first key of these functions is the extended 
function (Exit) key. Once you press this key, the cursor begins to blink. It continues to blink until 
you press another key. A blinking cursor also occurs in the bottom left of the screen if the key- 
board is locked, if a transmission is pending, or if a print is in progress. 

3.4.2.4 Display Messages. ICS displays a message on the bottom line of the screen when it 
detects an error. If you pressed a program attention key (refer to paragraph 3.4.4.13) immediately 
prior to the message display, you should assume that the transmission did not take place. When 
an error occurs, the ICS station either suspends or terminates, depending on the type of error. Fur- 
ther information about these messages can be found in Appendix B. 

Some errors cause the keyboard to lock, and a blinking cursor appears on the bottom line of the 
screen in the first character position. Either the host application or the ICS station operator can 
reset the keyboard. When the keyboard is reset, you can continue to enter data or edit the con- 
tents of the screen. ICS redisplays the original bottom line and repositions the cursor to its pre- 
vious location. 

To reset most video terminal keyboards, press Exit + R. 

3.4.3 Special Features 

Two special features, automatic skip and audible alarm, aid in data entry and editing a display. 
Automatic skip speeds up the editing and entry of data by skipping protected fields. The audible 
alarm sounds when you use keys improperly. 

3.4.3.1 Automatic Skip. When you enter a character into the last character position of an 
unprotected field, the cursor automatically skips any protected fields and stops at the first char- 
acter position of the next unprotected field. 

If the cursor is in the last character position of the last unprotected field of a display and you 
press a data key, the cursor wraps around to the first character position of the first unprotected 
field. 
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3.4.3.2 Audible Alarm. An audible alarm sounds when you press a data key or an erase key in 
any of the following situations: 

• The cursor is positioned in a protected field 

• The keyboard is locked 

• The keyboard is in the insert mode, but the field is already full 

• A hardware error is detected on the video terminal 

3.4.4 Key Functions 

The alphabetic, numeric, and special character keys operate as typewriter keys. Other keys per- 
form functions unique to ICS. The following paragraphs describe these keys. Table 3-5 shows 
which keys on each ICS-supported video terminal emulate keys on an IBM 3277 Model 2 Display 
Station equipped with an EBCDIC typewriter keyboard. The following list shows the types of key 
functions that ICS supports: 

Repeat 

Cursor movement 

Field movement 

Tab 

Editing 

Suspend 

Terminate 

Print 

Reset 

Duplicate 

Field mark 

Alpha override 

Program attention 
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3.4.4.1 Repeat Function. The REPEAT key performs the repeat function on the 911 and 915 
terminals by emulating an extension of the IE>M typamatic feature. An IBM typamatic key repeats 
when you hold it down. The data keys and the cursor control keys are typamatic on all VDT 
terminals except the 911, 915, 940, and Business Systems terminals. Only the space bar and the 
cursor movement keys are typamatic on IBM keyboards. The REPEAT key on a 91 1 or 915 ICS dis- 
play Station works in conjunction with all data keys as well as with the cursor movement keys. The 
REPEAT key causes the next key pressed to repeat as long as the REPEAT key is held down. To 
use the repeat function, you must press the REPEAT key before you press the key whose action is 
to be repeated. The only keys that do not repeat are mode keys that produce no key codes them- 
selves. These keys generate code only when used in conjunction with a data key. 

The following list shows mode keys that do not repeat: 
SHIFT 

• CONTROL 

UPPERCASE LOCK 

INSERT CHARACTER 

You can modify the local configuration of the 940 and Business System terminals so that the typa- 
matic feature is disabled. 

3.4.4.2 Cursor Movement Functions. The Previous line, ( ) next line, ( ) previous character, 
(*-) next character, (-*) keys move the cursor one character position at a time. These keys oan 
move the cursor into any position on the screen, without concern for attribute characters or pro- 
tected fields. Using these keys in a field does not mark the field as modified. These keys do not 
move the cursor off the screen. If the cursor is already at an edge of the screen, the cursor wraps 
horizontally and vertically as follows: 

• When you move the cursor off the screen to the left of the first character position while 
on lines 2 through 24 (the bottom line), it reappears in the eightieth character position of 
the line above. 

• When you move the cursor off the screen to the left of the first character position while 
on the top line (line 1), it reappears in the eightieth character position of the bottom line. 

• When you move the cursor off the screen to the right of the eightieth character position 
while on lines 1 through 23, it reappears In the first character position of the line below. 

• When you move the cursor off the screen to the right of the eightieth character position 
while on the bottom line, it reappears in the first character position of line 1. 

• When you move the cursor below line 24 (the bottom line) of the screen, it reappears on 
line 1 in the same column it appeared on line 24. 

• When you move the cursor above line 1 of the screen, it reappears on the bottom line in 
the same column it appeared on line 1 . 
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The field movement, Skip, and Return keys move the cursor left and right in the same manner 
except that they position the cursor in the first character position of unprotected fields only. The 
skip function is a combination of the tab and erase to end-of-field functions. An option is available 
that switches the function of the tab and skip keys on the 91 1 and 915 terminals. Consult your sys- 
tems operator to determine whether this option is enabled. 

3.4.4.3 Field Movement Functions. The left-field, right-field, home-cursor, and new-line func- 
tions move the cursor by whole fields according to those existing on a given screen. 

Field Left Function. The field left operation moves the cursor to the first position of the first 
unprotected field to the left of and/or above the position of the cursor. If there are no unprotected 
fields, the cursor moves to the first character position (upper left corner) of the screen. Table 3-5 
shows which keys perform the field left function for each ICS-supported terminal. 

Field Right Function. The field right operation moves the cursor to the first position of the first 
unprotected field to the right of and/or below the position of the cursor. If there are no unprotected 
fields, the cursor moves to the first character position of the screen. Table 3-5 shows which keys 
perform the field right function for each ICS-supported terminal. 

Cursor Home Function. The Home key moves the cursor to the first position of the first unpro- 
tected field of a formatted screen or to the first character position of an unformatted screen. 

New Line Function. The Return key moves the cursor to the first position of the first 
unprotected field on a subsequent line. If there are no unprotected fields, the cursor moves to the 
first character position on the screen. If there are no fields, the cursor moves to the first character 
position of the next line. 

3.4.4.4 Tab Functions. ICS provides two modes of tabbing: TABS and WORD. ICS lets you 
alternate between WORD mode and TABS mode. You can also set fixed tabs for use in the tab 
mode. Finally, ICS provides a special type of tab that positions the cursor at the end of a word. ICS 
provides the following tab function keys: 

• TAB — Moves the cursor forward to a position determined by which mode is active: 

— TABS mode positions the cursor according to preset tabs 

— WORD mode positions the cursor according to the data within the field 

• Alternate from one tab mode to the other — < extended function> + M 

• Append cursor to the position after the last nonblank character in the field — 

< extended function> + P 

TAB Key (skip Key). To perform the tab function on a VDT, press the Forward Tab. In this manual, 
this sequence is indicated as TAB. 

The tab function on the 911, 915, and Business System terminals can optionally be interchanged 
with the skip function so that when you press the Skip key, the tab function is performed. Alter- 
nately, when this option is used, the skip function is performed when you press TAB. Consult your 
systems operator to determine whether this switching option is enabled. 
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Switch Between Tab Modes. The < extended function> +M key combination allows you to 
alternate tab modes between TABS and WORD. After activation, ICS begins in TABS mode. Press- 
ing TAB moves the cursor to preset tab stops, retained from session to session according to user 
ID. Pressing < extended function> + M changes the tab mode to WORD, where pressing Forward 
Tab moves the cursor to the next word in the field. Like a toggle switch, subsequent use of the 
< extended function> + M sequence changes tab modes from one to the other. 

The tabs for the TABS mode are set the same as tabs used by the DX10 operating system Text 
Editor. The SCI command, Modify Tabs (MT), enables you to change your tab settings. To use the 
MT command, you must first suspend ICS at your terminal to regain access to SCI. To suspend 
ICS, press the command key. Then enter MT to display the existing tab stops. Enter new tabs as 
desired, separated by commas. Refer to the DX10 Text Editor Reference Manual for further infor- 
mation concerning the MT command. ICS uses these tabs within each modifiable field. If you set 
tabs at 1, 5, and 15 and place the cursor at the first character position of an unprotected field 
(immediately to the right of the unprotected field indicator), the following occurs: 

• When you tab the first time, the cursor moves to the fifth character position within the 
field (the cursor is already at position one). 

• When you tab the second time, the cursor moves to the fifteenth character position 
within the field. If the field is less that 15 characters in length, the cursor moves to the 
first character position of the next unprotected field. 

• When you tab the third time, the cursor moves to the first character position of the next 
unprotected field. 

Whenever the tab position exceeds the length of the field, the cursor moves to the first character 
position of the next unprotected field. The TABS mode treats the beginning of a field as a perma- 
nent tab stop. Using the tab function moves the cursor to the next tab stop or the beginning of the 
next unprotected field, depending on which comes next on the screen. 

In WORD mode, the cursor stops at the beginning of each word, which is a string of letters. It skips 
over spaces, nulls, numerals, and symbols — including the decimal point. When the field has no 
further words, tabbing moves the cursor forward four character positions at a time. When the cur- 
sor reaches the end of a field, it moves to the beginning of the next one. For example, tabbing at 
the beginning of the field "(** JULY 4, 1776 **)" moves the cursor to J and then on to the begin- 
ning of the next field. 

The DX10 operating system keeps a record of tab stops used by ICS for each station under the 
user ID given at SCI log-on. When you execute ICS, it retrieves the positions of the tab stops saved 
when ICS was terminated, and these become the tab stops for the new session. 
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Append-Cursor Function. The append-cursor function moves the cursor to the end of the data in 
a field. If you press < extended function> + P the cursor moves to the position after the last non- 
blank character in the field. If the field contains nothing but blanks and nulls, the cursor moves to 
the beginning of the field. If the last position in the field holds a nonblank character, the cursor 
moves to the position to the right of the nonblank character. The following example demonstrates 
the results of using Exit + P on a VDT terminal then entering the letter X: 

Field Result 

"ABC "ABCX 

"ABCD "ABCDX 

"ABCDEF "ABCDEF " "X 

n ii y ii ii 

3.4.4.5 Editing Functions. The erase-field, erase-input, skip, insert-character, and delete- 
character functions edit the display supplied by the host application program or entered by the 
operator. The ERASE EOS key on the 940 terminal performs the erase-to-end-of-screen (EOS) func- 
tion. A two-key sequence on the other terminals performs the erase-to-EOS function. 

Erase Field Function. The erase-field operation erases the field from the beginning of the field 
to the end of the field even if that field continues to another line. The erase field operation 
replaces with nulls all the information in an unprotected field, and marks the field as modified. 
The nulls appear as blank characters. After the erase-field operation, the cursor appears at the 
beginning of the field. If you position the cursor in a protected field or over an attribute character 
and perform the erase-field operation, the audible alarm sounds, all data remains, and the cursor 
moves to the first position of the protected field. When you position the cursor over a protected 
field or an attribute character, the cursor blinks. Table 3-5 shows which keys perform the erase- 
field function for each of the ICS-supported terminals. 

Skip Key. The Skip key replaces with nulls all the data from (and including) the cursor position 
to the end of the field. After the operation, the cursor appears at the beginning of the next unpro- 
tected field. 

The Skip key on a VDT terminal performs the skip function. Usually, you perform the skip function 
on a VDT terminal by pressing the Skip key without holding the Shift key down. An option is avail- 
able to interchange the tab and skip functions so that when you press the Skip key unshifted, you 
perform the tab function. When this option is enabled, the (Shift) Skip performs the skip function. 
This option prevents accidental erasure of data caused by keystroke errors. Usually, if you press 
the Skip instead of (or in addition to) the Return key, you erase data. Consult your systems opera- 
tor to determine whether this option is enabled. 
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The Skip key performs a similar operation to the erase-field key, except that it does not erase the 
data within the field to the left of the cursor. The Skip key also moves the cursor differently after 
the erase-field operation. The erase-field operation erases all the data in the field regardless of the 
cursor's position within the field. The Skip key performs both erase and cursor movement opera- 
tions and marks the field as modified. If the cursor is in a protected field or over an attribute char- 
acter and you press the Skip key, the audible alarm sounds, the operation is not performed, and 
the cursor moves to the first character position of the next unprotected field. 

Erase-input Function. The erase-input operation replaces all unprotected fields with nulls 
(displayed as blanks) and moves the cursor to the first unprotected characterposition on the 
screen. The cursor's position does not affect operation of the erase input function. If all fields on 
the screen are protected, the cursor moves to the first position on the screen, and the data in the 
protected fields is not modified. If no fields exist on the screen, the entire screen clears and the 
cursor moves to the first position on the screen. This operation does not mark the fields as modi- 
fied. Table 3-5 shows which keys perform the erase-input operation for each of the ICS-supported 
terminals. 

ErasetoEnd-of-Screen (EOS) Function. The erase-to-EOS function is not a standard 3270 func- 
tion. This function replaces with nulls all data in every unprotected field from the current cursor 
position to the end of the screen. This function does not modify the protected fields. Table 3-5 
shows which keys perform the erase to EOS operation for each of the ICS-supported terminals. 

Delete Character Function. If you press the delete character key while the cursor is in an unpro- 
tected field, you delete the character at the cursor position. As you delete each character, the char- 
acters to the right of the cursor in the same field shift one character position to the left. The cursor 
does not move. The field in which the deletion takes place is marked as modified. As the charac- 
ters shift left, nulls replace the character positions at the end of the field. If the field con- 
tinues to the next line, the characters on the next row do not move. The delete character function 
does not wrap across lines. When the cursor is on an attribute character or in a protected field, 
pressing the delete character key does not modify any character positions. If the cursor is in a pro- 
tected field, the audible alarm sounds. 

Insert-Character Function. The insert-character operation puts the keyboard in the insert mode. 
In this mode, you can insert characters into unprotected fields. The insert operation can take 
place only if nulls are in the field to the right of the cursor. If the field continues to the next row, 
characters do not move from the last character position of the row containing the cursor to the 
first character position of the next row. If the field is already filled with characters (other than 
blank spaces), no insert takes place. In addition, and the audible alarm sounds when you press the 
key. 
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The Insert Character key performs the insert-character operation on all ICS-supported terminals. 
Once you press the Insert Character key, each character you enter appears at the cursor position. 
The cursor and the data at and to the right of the cursor shift to the right one character position for 
each character you insert. When an insert operation takes place, the field is marked as modified. 
When alphanumeric characters occupy all positions of the field, no more insertions in that field 
can occur. The insert operation does not shift attribute characters. When a field occupies more 
than one row and the characters in the field reach the end of a row, any additional inserts cause 
the characters to shift to the next line, provided that there are blank or null characters at the end 
of the field. The insert operation terminates when you perform any of the following operations: 

Erase input 

Erase field 

Cursor movement: (previous character( ), next character ( ), previous line ( ), next 
line( ), 

Field left 

Field right 

Tab 

Skip 

New line (Return) 

Extended function (Exit key) 

Suspend function (Command key) 

Delete character 

Program attention (See paragraph 3.4.4.13.) 

Print screen 

Clear 

Table 3-5 lists cursor control and edit functions on all ICS-supported keyboards. 
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Table 3-5. Cursor Movement and Edit Function Key Mapping 



Function 



Generic Key Sequence(s) 



Cursor right 

Cursor left 

Cursor up 

Cursor down 

Cursor to the first character 
position within the first 
unprotected field 

Cursor to the first character 
position within the next 
unprotected field 

Cursor to the first character 
position within the previous 
unprotected field 

Switch tab mode between TABS 
and WORD mode 

Tab according to the current 
tab mode 

Append cursor to the end of 
a word 

Erase entire field 

Erase to end-of-f ield 

Erase input 

Erase to end-of-screen 

Delete character 

Insert character 



Next Character 
Previous Character 
Previous Line 
Next Line 
Home 

Next Field 

Previous Field 

Exit + M 

Forward Tab 

Exit + P 

Erase Field 

Skip 

Erase Input 

Exit + E 

Delete Character 

Insert Character 



3.4.4.6 Suspend Function. This function suspends an ICS video station. To suspend ICS at a 
911 or Business System terminal, press the orange command key (CMD). To suspend ICS, press 
the command key. To suspend ICS at a 915 terminal, press the F9 key. Paragraph 3.3.1 provides a 
complete explanation of ICS suspension. 
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3.4.4.7 Terminate Function. This function terminates the ICS video station. To terminate an 
active ICS display station, press < extended function> + Q. Paragraph 3.3.2.2 provides more detail 
about ICS station termination. 

3.4.4.8 Print Functions. The following paragraphs describe the Print key, how to cancel a print 
order, and how to change the pathname assigned to the Print key. 

Print Key. The Print key allows you to print the contents of the screen or copy it onto a file. When 
you press the Print key, the cursor does not move but begins to blink. When the print operation is 
completed, the cursor stops blinking and you can continue to enter data or edit the display. 

If the Print key pathname is assigned to a file that already contains some data, that data is not 
lost. The contents of the screen are appended to the file. 

If you assign the Print key pathname to a print queue device such as LP$1 and press the Print key, 
the cursor continues to blink until the contents of the screen are forwarded to the queue. If the 
printer assigned to the designated print queue is printing another job, it cannot print your order 
immediately. Your job is not lost, however. As soon as the printer finishes with the jobs ahead of 
yours in the queue, your screen is printed. 

You can locally configure the 940 and Business System terminals to disable the Print key. You can 
also disable the auxiliary printer attached to these terminals. 

Cancel Print Function. If you have pressed the Print key and the cursor is still blinking, you can 
cancel the print order by pressing the Print key again. Output at the Print device halts, the cursor 
stops blinking, and you can continue to enter data or edit the display. If the cursor has stopped 
blinking, the print has been completed, and there is no need to cancel it. 

Identification Function (ident). The identification function changes the Print key pathname 
assigned to your ICS display station. Table 3-6 shows which keys perform the indentification 
operation for each ICS-supported terminal. After you perform the identification function, ICS sus- 
pends itself, erases the bottom line, and displays a prompt in its place. The prompt has the follow- 
ing general form: 

Line= CMxx Term= yy, Printer: zz 

Line = CMxx identifies the ICS communications line that you are using. The value xx is the 
numerical portion of the device access name. Term = yy identifies the terminal address that you 
are using. The value yy is the decimal terminal address in the range of through 31 . The communi- 
cations line name and terminal address are displayed only for your information; you cannot 
modify them. The only element that you can modify is zz. The initial value displayed for zz is the 
value that is currently installed as the Print key pathname. This value is set when you activate the 
ICS station. 

To change the Print key pathname, enter the desired pathname. ICS returns, and the screen 
appears exactly as it did before you performed the identification function. If you enter a null value 
or DUMY into this field, your station has no Print key pathname and no action occurs when you 
press the Print key. If you disable your Print key and perform the identification function again, the 
initial value is represented as DUMY. The Print key pathname value is the same value specified 
when activating an ICS video terminal. The same rules apply (paragraph 3.2.1 .5). 
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3.4.4.9 Reset Function. The reset function unlocks the keyboard. If the cursor is blinking at the 
first character position of the bottom line of the screen, the keyboard is locked. The host applica- 
tion usually locks and unlocks the keyboard to inhibit input while it is processing data. Unless a 
transmission is currently in progress, you can unlock the keyboard by performing the reset func- 
tion. Table 3-6 shows which keys perform the reset function for each ICS-supported terminal. 

If there is a pending transmission, no action occurs. 

3.4.4.10 Duplicate Functions. You can duplicate the contents of the previous field into the cur- 
rent field by using either the local duplicate or the remote duplicate function. The remote dupli- 
cate function enters a special code into the current field, and this special code is transmitted to 
the host with the rest of the data entered. The host application serving the ICS station interprets 
this code and performs the duplicate function. The local duplicate function duplicates the con- 
tents of the previous field before the transmission occurs. 

Local Duplicate Function. The local duplicate function copies the contents of the previous mod- 
ifiable field into the current field. The data appears on the screen the same as if you had entered it 
manually except that it appears in low intensity. Table 3-6 shows which keys perform this opera- 
tion on each of the ICS-supported terminals. If the cursor is in the first modifiable field of the 
screen, the contents of the last modifiable field of the screen are copied into the current field. Pro- 
tected (unmodifiable) fields are ignored. If the current field accepts only numeric data and the pre- 
vious field contains nonnumeric data, the audible alarm sounds and no action occurs. Similarly, if 
the current field is protected (indicated by a blinking cursor),the audible alarm sounds and no 
action occurs. 

Remote Duplicate Function. When you perform this function and the cursor is in an unprotected 
field, a special code is entered at the cursor position. This special code indicates to the host appli- 
cation program that a duplicate operation should be performed for the rest of the field. When the 
host application performs the duplicate operation, it usually copies the contents of the previous 
modifiable field into the field containing the special code. ICS merely sends the code; the host 
application can interpret it in a number of different ways. The special code appears as the graph- 
ics character shown in Figure 3-3. 

When this character appears, the cursor moves to the first character position of the next unpro- 
tected field. The field displaying the graphics character is marked as modified. Performing the 
duplicate function while the cursor is in a protected field or on an attribute character sounds the 
audible alarm but does not write the code or move the cursor. 

Table 3-6 shows which keys perform the remote duplicate operation on each ICS-supported 
terminal. 

3.4.4.11 Field Mark Function. The field mark function enters an end-of-field mark in an unfor- 
matted display image or, in a formatted display image, enters an end-of-subfield mark. ICS dis- 
plays the end-of-field mark character as the graphics character shown in Figure 3-4. 
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2282170 




Figure 3-3. Remote Duplicate Graphics Character 



2282171 




Figure 3-4. Field Mark Graphics Character 



Table 3-6 shows which keys perform the field mark operation on each ICS-supported terminal. 
The field is marked as modified. If the cursor is in a protected field or on an attribute character, the 
cursor blinks. If you try to perform the field mark operation when the cursor is in a protected field 
or over an attribute character, the audible alarm sounds, and no action occurs. 

3.4.4.12 Alpha Function. The alpha function allows you to enter a nonnumeric character into a 
numeric field. Numeric characters include through 9, the minus sign ( - ), and the decimal point 
( . ). Some international keyboards use the comma as a valid numeric character, instead of the 
period. 

Table 3-6 shows which keys perform the alpha function on each ICS-supported terminal. To per- 
form this function, first position the cursor at the beginning of the numeric field, then press the 
appropriate keys. 

3.4.4.13 Program Attention Functions. The program attention operation requests the attention 
of the host application program. Performing one of the program attention functions locks the key- 
board and sends an attention identification (AID) code to the host application program, identifying 
which action is requested. The application program takes the appropriate action. After the appli- 
cation program acts on the attention request, the program(s) may reinitialize the keyboard. ICS 
supports the following program attention functions: 

• Clear 

• Enter 

• Program function 1 through 24 

• Program access 1 through 3 
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Clear Function. The clear operation clears the entire screen to nulls, moves the cursor to the 
first character position on the screen, and transmits an attention identification (AID) code to the 
host. 

Table 3-6 shows which keys on each ICS-supported terminal perform the clear function. 

Enter Function. The enter operation transmits the display image to the host application 
program. Only modified fields (whose attribute characters indicate that they are modified) are 
transmitted. 

Table 3-6 shows which keys on each ICS-supported terminal perform the enter function. 

Program Function (PF) Keys. The host application program defines the PF keys on the IBM 3277 
Model 2 Display Station to request program action, which usually involves reading data from the 
buffer of the ICS display station. When you press a PF key, the AID code and the modified data in 
the buffer of that station are transmitted to the host application program. 

Table 3-6 shows which keys on each ICS-supported terminals perform the program function oper- 
ation. You can choose from several ways to perform the program function operation for most of 
the emulated AID codes. 

Program Access Function. The host application program defines the program access keys on 
the IBM 3277 Model 2 Display Station to request program action without requiring that data be 
read from the buffer of the ICS video station. When you press one of the program access keys, 
only the program access key code is transferred to the application program. The only difference 
between program access keys and PF keys is that a program access key sends only the key code, 
while a PF key transmits the modified fields as well as the key code. ICS emulates three program 
access keys, PA1 through PA3. The 940 terminal uses the P1, P2, and P3 keys. Table 3-6 shows 
which keys on each of the ICS-supported terminals emulate program access keys. 



Table 3-6. Special Function Key Mapping 

Special Function Generic Key Sequence(s) 

Suspend ICS station Command 

Terminate ICS station Exit + Q 

Print screen Print 

Cancel print Print + Print 

Cancel extended function mode Exit + Exit 

Identify printer (also ICS line Exit + I 
and terminal address) 

Reset (unlock keyboard) Exit + R 

Local duplicate Exit + L 
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Table 3-6. Special Function Key Mapping (Continued) 



Special Function 



Generic Key Sequence(s) 



Remote duplicate 

Field mark 

Alpha (override numeric 
protection) 

Clear 

Enter (send to host) 

Program function keys PF1 
through PF8 



Program function keys PF9 
through PF24 



Program access key PA1 
Program access key PA2 
Program access key PA3 

Notes: 

1 These keys are F9 through F24 on a 940 EVT. 

2 This sequence is (ALT)P1 on a 940 EVT. 

3 This sequence is (ALT)P2 on a 940 EVT. 

4 This sequence is (ALT)P3 on a 940 EVT. 



Exit+D 
Exit+F 
Exit + A 

Initialize Input 

Enter 

F1 

through 

F8 

Exit + 09 *1 
through 
Exit + 24 

Exit++ *2 
(plus) 

Exit+ - *3 
(hyphen) 

Exit + _ *A 
(underscore) 



Once you press the first key of this sequence on any of these terminals, the keyboard locks, and 
the cursor blinks in the first column of the bottom row. When you press the second key, the pro- 
gram access key code is transmitted to the host application. What happens next depends on how 
the host application is programmed to handle the particular program access code. To unlock the 
keyboard, use the reset function. Paragraph 3.4.4.9 explains the reset function. 
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4.1 INTRODUCTION 

This section is for systems personnel responsible for the installation and maintenance of the 
DX10 3270 Interactive Communications Software (ICS) package. The procedures it describes are 
not necessary for everyday operation. This section provides a more detailed explanation of how 
ICS uses the hardware. It explains the meaning of the parameters used in ICS installation and how 
they can be modified. In addition, this section describes the following SCI command procedures: 

List Interactive Communications Configuration (LICC) 

Modify Interactive Communications Configuration (MICC) 

Modify ICS Control Unit Address (MCUA) 

List Interactive Communications Statistics (LICS) 

Execute Interactive Communications Controller (XICC) 

Execute Poll Analyzer (XPA) 

4.2 INSTALLATION 

The following paragraphs describe the installation of ICS. Besides installing the hardware in the 
correct slots of the backpanel with the correct jumpers and necessary cables, the software must 
also be correctly generated and installed for a specific configuration. All of the operations 
described in the DX10 3270 ICS Object Installation document must have been successfully 
completed, specifically; 

• Remote Terminal Subsystem (RTS) installation and generation (if used) 

• DX10 operating system installation and generation 

• ICS installation and generation 

To use the LP$x form for printer pathnames, you must ensure that the system directory .S$PRINT 
is installed on your DX10 operating system. The DX10 Operating System Production Operation 
Manual, Volume II describes this directory and the operation of print queue access names. 
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Any Texas Instruments video display terminal installed on the DX10 operating system can be used 
as an ICS station. During the installation procedure, you must define to the operating system all of 
the hardware necessary for ICS operation. You must specifically define only the communications 
controller as ICS hardware. You do not define the 911 and 915 terminals as ICS stations during 
system generation. If you use Programmed Station Control (PSC), ICS requires that you specify 
more intertask communication area to handle the interface between the PSC Emulator and your 
PSC program. This requirement is described in the DX10 3270 ICS Object Installation document. 
For complete information about system generation and installation, see the DX10 Operating 
System Systems Programming Guide, Volume V. 

The following paragraphs describe the modifications to the Initialize System (IS) procedure 
recommended to automate the initialization of ICS. You do not have to make these modifications. 
If you do not, however, you must perform them manually after each initial program load (IPL) of the 
990 computer. The recommended modifications are as follows: 

• Logical unit number (LUNO) assignment and protection 

• Downloading of the character detect routines for some versions of communications 
controllers 

• Modify Control Unit Address (MCUA) or Modify Interactive Communications 
Configuration (MICC) if your configuration requires these modifications 

• Activation of the ICS line (XICC) 

4.2.1 Required DX10 LUNO 

ICS requires the use of the DX10 global LUNO >22. You must assign the required LUNO and pro- 
tect it from deletion. You should incorporate these steps into the IS command procedure so that 
they need not be performed manually. Once you correctly modify the IS procedure, you need only 
be sure to initialize the DX10 operating system after each IPL so that ICS is operational. The modi- 
fications you need to make to the IS procedures are described in the DX10 3270 ICS Object Instal- 
lation document. 

4.2.2 Activate Communications Controller Task — XICC 

Before you can activate any ICS stations, you must activate the communications line. For multiple 
line configurations, you must activate each line individually, once after each IPL. The line 
responds to host polls and selects even when no ICS stations are active on that line. 

To activate an ICS communications line, enter XICC in response to the SCI prompt. The following 
display appears on the screen: 



[ ] XICC 



EXECUTE INTERACTIVE COMMUNICATIONS CONTROLLER 
COMMUNICATIONS LINE NAME: 
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The only parameter displayed is the COMMUNICATIONS LINE NAME prompt, which is the device 
name of the communications port or a synonym for such a value. The general form is CMxx, where 
xx indicates a specific port. If you enter a null value, ICS searches the list of installed ICS lines in 
the order that you declare them during installation and selects (as the default) the first inactive 
line. 

Upon successful activation, ICS returns a message. For example, if you activate CM03, ICS 
displays the following message: 

*XICC-COMMUNICATIONS LINE CM03 ACTIVATED: 

Because you must activate an ICS line only once after each IPL, you may find it convenient to 
include the activation command in the IS procedure. If you have only one ICS line on your system, 
you can add XICC/ to your IS procedure. The slash (/) is an SCI primitive command and is 
required. You do not need to specify the communications line name. If you do not, ICS searches a 
list of installed lines and selects the first inactive installed ICS line it finds when no line is speci- 
fied. If you have more than one line installed, include XICC/ twice in the IS procedure. The only 
time you need to specify the line name is when you have more than one line installed and you do 
not want to activate the one that was declared first during installation. For example, if you 
declared CM01 first during installation and CM02 second, you can activate only CM02 by includ- 
ing the following line in the IS procedure: 

XICC COMMUNICATIONS LINE NAME=CM02 

Usually, the controller task remains active until you perform another IPL. Paragraph 4.6 contains a 
discussion of abnormal termination. 

If you want the ICS line to use a control unit address other than the one you assigned during 
installation, you must execute the Modify Control Unit Address (MCUA) command before you acti- 
vate the ICS line. Paragraph 4.3.3 describes the MCUA command. 

4.2.3 Downloading Character Detect Routines 

All releases of the Four-Channel Communications Controller (FCCC) and the Bit-Oriented, 
Character-oriented Asynchronous Interface Module (BCAIM) require downloading of the 3270 
bisync character detect routines. The modifications to the IS procedure that ICS requires for the 
downloading of these communications controllers are detailed in the DX10 3270 ICS Object 
Installation document. 
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4.3 CONFIGURATION MANAGEMENT 

ICS provides the following three commands that manage the ICS configuration: 

• List Interactive Communications Configuration — LICC 

• Modify Interactive Communications Configuration — MICC 

• Modify ICS Control Unit Address — MCUA 

4.3.1 List Interactive Communications Configuration — LICC 

The LICC command lists the installed configuration for a particular ICS line and current infor- 
mation about the use of resources assigned to that line. To execute this procedure, enter LICC in 
response to SCI. The following appears on the screen: 

[ ] LICC 

LIST INTERACTIVE COMMUNICATIONS CONFIGURATION 
COMMUNICATIONS LINE NAME: 
OUTPUT PATHNAME: 

Your response to the COMMUNICATIONS LINE NAME prompt identifies the communications con- 
troller, the specific port, and the associated IBM-compatible host. You can use any valid ICS line 
identifier (such as CM01) or synonym. 

Your response to the OUTPUT PATHNAME prompt identifies the location to which ICS writes this 
information. The default value for this field is the device name of the station at which you entered 
the command. The output pathname can be any valid pathname of a file, or any sequential output 
device name, such as LP01 for a printer. If you enter a null value, ICS uses the terminal at which 
you entered the LICC command as the output pathname. 

The following example shows how to generate the configuration listing for the ICS line identified 
byCMOI. 

C 3 LICC 

LIST INTERACTIVE COMMUNICATIONS CONFIGURATION 
COMMUNICATIONS LINE NAME: CM01 
OUTPUT PATHNAME: 
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ICS accepts the null value in response to the OUTPUT PATHNAME prompt and displays the 
following information at your terminal: 

3270 ICS RELEASE 2.2 - CONFIGURATION LISTING 

ID TYPE STATE RID INPUT PRINTER PATHNAME 



CTL ACTIVE 13 CM01 

CRT IDLE LP$2 

1 CRT ACTIVE DA ST14 LP$2 

2 CRT PSC-WAIT F2 LP$1 

3 CRT PSC-ACTV F1 LP$1 

4 PRT ACTIVE 11 . S YS1 . P3270 . MARCH . S A LES 

5 CRT DISABLED LP$1 

6 CRT SUSPENDED ST08 DS02 . J AC K . M I S C . PR I NTER 

The first line of the display identifies the release number of the ICS package that your system uses 
and identifies the display as a configuration listing. The next line is a header that identifies the 
type of information for each field. The line immediately below the header contains information 
about the communications line. 

The communications line is identified by type CTL, which is an abbreviation of controller. The 
number below the ID identifies the decimal control unit address assigned to the ICS line. The state 
can be either active or inactive. The two-digit hexadecimal number below RID identifies the task 
run ID of the controller task for this ICS line. ICS displays CM01 beneath INPUT on this line to iden- 
tify the device name of the communications controller that this ICS line uses. No printer path- 
name is displayed since printers are not assigned directly to communications lines. 

A blank line separates the communications line information from the information about the 
individual terminal addresses reserved for that line. This display lists each reserved terminal 
address in numerical order from to the highest installed terminal address in the far left column 
headed ID. 

The second column indicates the installed station TYPE for each terminal address. Station type 
can be either CRT for video terminal or PRT for printer station. 

The third column indicates the current state of a particular terminal. Table 4-1 identifies all of the 
possible states and explains what they mean. 
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Table 4-1. Terminal States 



State 



Description 



ACTIVE Terminal address is in use by the station identified by the device name listed under 

INPUT. The listing shows the ICS station tasks run ID (beneath RID) and the printer 
pathname currently assigned to the terminal address. 

SUSPENDED Terminal address has been activated and suspended but not terminated. The ter- 

minal address remains reserved and unavailable for use by any other station until 
the station is terminated. Since the ICS station is no longer in the system, the dis- 
play shows no task run ID beneath RID. The station that reserves the terminal 
address is identified by the device name listed beneath INPUT. This display also 
shows the printer pathname currently assigned to this terminal address. 

PSC-ACTV ICS has assigned the terminal address to a currently active user-written PSC pro- 

gram. The task run ID listed identifies the copy of the PSC Emulator (ICSPSC) that 
serves the terminal address, not the user-written PSC task. No input device is 
shown for the terminal address. This display also shows the printer pathname cur- 
rently assigned to this terminal address. 

PSC-WAIT ICS has assigned the terminal address to a PSC Emulator. The PSC Emulator 

(ICSPSC) waits until the host sends more data across the line or until a user-written 
task issues an Open call. The task run ID identifies the PSC Emulator that serves 
the terminal address, not the user-written PSC task, which may or may not still be 
active. No input device is shown for the terminal address. This display also shows 
the printer pathname currently assigned to this terminal address. 

IDLE Terminal address is not active and is available for use. No input device or task run 

ID is associated with an idle terminal address. An idle terminal address does have a 
printer pathname assigned to it. 

DISABLED Terminal address is not active and not available for use. To enable a station, use the 

Modify Interactive Communications Configuration (MICC) command. Even though 
the terminal address is disabled, a printer pathname is assigned to it. 



4.3.2 Modify Interactive Communications Configuration — MICC 

The MICC command modifies either the state or type of a particular ICS terminal address. MICC 
can change the station type from CRT to PRT and vice versa, and it can change the state from 
enabled to disabled and vice versa. The terminal address must be idle or disabled. MICC cannot 
modify a terminal address that is in use. The MICC command permits dynamic configuration, 
which means that you do not have to reinstall ICS to modify your configuration. 

To change the ICS configuration to match the configuration of the host, use MICC prior to activat- 
ing the ICS line (XICC). 



4-6 



2250954-9701 



Functional Description 



NOTE 

Use of this command should be limited to modifications that match 
the configuration of the host. If the host expects a particular ter- 
minal address to be a printer station and you have modified that 
address to the video type, errors occur when the host sends printer 
commands and orders to your video station. 



To execute this command, enter MICC in response to the SCI prompt. The following display 
appears on the screen: 

C ] MICC 

MODIFY INTERACTIVE COMMUNICATIONS CONFIGURATION 

COMMUNICATIONS LINE NAME: 

TERMINAL ADDRES S (0-31 ) : 

STATECENABLED/DISABLED): 

TERMINAL TYPE ( CRT/ PRT) : 

The first two prompts identify the specific terminal address to be modified. ICS requires a valid 
response for both prompts. No default value exists for either the COMMUNICATIONS LINE NAME 
or the TERMINAL ADDRESS(0 - 31) prompts in this procedure. 

MICC modifies only one terminal address at a time. To change the type or state of a terminal 
address, enter the desired change in the appropriate field. If you enter a null value, no change 
occurs. You must have at least one video terminal address (type CRT) enabled on each installed 
ICS communications line. If you try to disable the last video terminal address or modify it to the 
PRT type, ICS displays the following error message: 

MICC-CANNOT MODIFY LAST CRT ADDRESS: 

As an example, assume that the configuration for CM01 is as shown in the previous output ex- 
ample for LICC and that the line is inactive. After I PL, each terminal address is enabled but idle. 
The type of each terminal address (CRT or PRT) is the type you assign when installing ICS. Also, 
the printer pathname for each terminal address is the default value that you assign during ICS 
installation. The following example demonstrates how to disable terminal address 05. Enter MICC 
and respond as follows: 

[ ] MICC 



MODIFY INTERACTIVE COMMUNICATIONS CONFIGURATION 



COMMUNICATIONS LINE NAME 

TERMINAL ADDRES S (0-31 ) 

STATE(ENABLED/DISABLED) 

TERMINAL TY PE ( C RT/ PRT) 



CM01 

05 

DISABLED 
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This changes terminal address 05 on the CM01 line from the enabled state to the disabled state. 
Since you enter no response to the TERMINAL TYPE (CRT/PRT) prompt, the type of terminal 
address 05 remains CRT. The MICC command automatically executes the LICC command for the 
communications line name that you entered. The following listing appears at your terminal: 

3270 ICS RELEASE 2.1 - CONFIGURATION LISTING 

ID TYPE STATE RID INPUT PRINTER PATHNAME 



CTL INACTIVE CM01 

CRT IDLE LP$2 

1 CRT IDLE LP$2 

2 CRT IDLE LP$1 

3 CRT IDLE LP$1 

4 PRT IDLE LP$1 

5 CRT DISABLED LP$1 

6 CRT IDLE LP$1 

You cannot execute the MICC command for a terminal address that is active or suspended. Also, 
you cannot execute the MICC command for an active ICS line. For example, if you attempt to 
modify any terminal address on CM01 when CM01 is active, the following error message appears: 

*MICC-CANN0T MODIFY ICS CONFIGURATION FOR ACTIVE LINE CM01 

4.3.3 Modify Control Unit Address — MCUA 

The MCUA command changes the control unit address assigned to an inactive ICS communica- 
tions line. You should use this command only to select the control unit address that the host con- 
figuration expects for your ICS line. To execute this command, enter MCUA in response to the SCI 
prompt. The following prompts appear: 

[ 3 MCUA 

MODIFY CONTROL UNIT ADDRESS 

COMMUNICATIONS LINE NAME: 
CONTROL UNIT ADDRESS (0-31 ) : 

Enter the device name of the communications controller port assigned to the ICS line in response 
to the COMMUNICATIONS LINE NAME prompt. Respond to the CONTROL UNIT ADDRESS (0-31) 
prompt with the desired decimal control unit address. 

If for any reason MCUA cannot perform the modification, ICS returns an error message. If the mod- 
ification is successful, ICS also returns a message. For example, if you use MCUA to change the 
control unit address of the ICS line identified by CM01 from to 3, ICS displays the following 
message: 

*MCUA-C0NTR0L UNIT ADDRESS FOR CM01 MODIFIED FROM TO 3: 
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4.4 LIST INTERACTIVE COMMUNICATIONS STATISTICS — LICS 

ICS maintains statistics for all activity that occurs after the activation of a communications line. 
This information aids in recognizing problems in hardware and user-written software. To execute 
this command, enter LICS in response to the SCI prompt. The following prompts appear on the 
screen: 

[ ] LICS 

LIST INTERACTIVE COMMUNICATIONS STATISTICS 
COMMUNICATIONS LINE NAME: 
OUTPUT PATHNAME: 

Your response to the COMMUNICATIONS LINE NAME prompt is the device name of the ICS com- 
munications controller port. Your response to the OUTPUT PATHNAME prompt can be the name 
of any file or sequential device. If you enter a null value, ICS writes the statistics listing to the 
video terminal at which you entered LICS. The following is an example of the listing: 

3270 ICS RELEASE 2.2 - STATISTICS LISTING 

CM01 - 15:19:32 WEDNESDAY, SEPTEMBER 04, 1983 

INBOUND OUTBOUND 



MESSAGE/EOT 82 21625 

BLOCK 132 11 

RETRANSMISSION 43 

ABORT/RVI 

COMMAND REJECT N/A 

POLL 21684 N/A 

GENERAL POLL 21684 N/A 

SPECIFIC POLL N/A 

POLL ERROR N/A 

SELECT ERROR N/A 

BUFFER ERROR N/A 

Only the host performs selects and polls, so the select and poll information is listed only in the 
inbound column. Other statistics are kept for both as follows: 

• Inbound — From host to ICS 

• Outbound — From ICS to host 

4.4.1 Message 

ICS increments the inbound message count every time it receives an end-of-transmission (EOT) 
character. ICS increments the outbound message count every time it transmits an EOT. 

4.4.2 Block 

ICS increments the inbound block count every time it receives a start-of-text (STX) character. ICS 
increments the outbound block count every time it transmits an STX. 
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4.4.3 Retransmission 

The retransmission count is the number of blocks that ICS (outbound) and the host (inbound) 
retransmit in response to a negative acknowledgment (NAK). 

4.4.4 Abort 

The abort count indicates the number of times that ICS sends a reverse interrupt (RVI) line control 
character (outbound) and the number of times ICS receives an RVI (inbound). 

4.4.5 Command Reject 

ICS counts the number of 3270 commands, such as Copy or Read Buffer, that it has rejected. The 
outbound count is the number of commands from the host that ICS has rejected. Rejection means 
that ICS recognized a command but did not execute it. 

4.4.6 Polls 

ICS maintains a count of all polls it receives. The poll count is the total number of polls ICS 
receives for the control unit address assigned to the ICS line. The total number of polls is the 
number of specific polls plus the number of general polls. The host uses a specific poll to request 
the attention of a particular terminal address configured on the ICS cluster. The host uses a gen- 
eral poll to ask if any of the terminal addresses on the ICS cluster require servicing. 

Each ICS station or Programmed Station Control task serving as an ICS station has a terminal 
address assigned to it when activated. If the ICS device service routine (DSR) receives a specific 
poll, it transmits data only when the station with the terminal address specified in the poll has a 
transmit pending. If the ICS DSR receives a general poll, it transmits when any of its stations has 
data to send. 

4.4.7 Poll Error 

ICS increments the poll error count every time the host polls ICS and specifies a terminal address 
that ICS cannot access. This error can occur if you do not reserve the address specified during 
installation. 

4.4.8 Select Error 

A select station error occurs when the host tries to initiate a transmission to a specific terminal 
address on the cluster but ICS cannot access that terminal address. This error can occur if you do 
not reserve the specified address during installation. 

4.4.9 Buffer Error 

The buffer error occurs when the host selects ICS to receive a transmission and ICS has no avail- 
able buffers in which to store the transmission. 



4.5 EXECUTE POLL ANALYZER - XPA 

The XPA command generates a limited trace of polls passing between ICS and the host. XPA 
works by dumping the poll buffer and status message buffer to the specified listing device in a 
manner similar to the List System Memory (LSM) command. 
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To execute the poll analyzer, enter XPA in response to the SCI prompt. The following prompts 
appear: 

[ ] XPA 

EXECUTE POLL ANALYZER 

COMMUNICATIONS LINE NAME: 

NUMBER OF SAMPLES: 7 
LISTING ACCESS NAME: ME 

Your response to the NUMBER OF SAMPLES prompt determines how many lines of trace output 
ICS returns. This prompt requires a response. Enter a decimal value. 

The response to the LISTING ACCESS NAME prompt determines where ICS writes the output list- 
ing. The initial value for this prompt is the station at which you entered the command. Your 
response to the LISTING ACCESS NAME prompt can be any sequential output device (for 
instance, LP01). 

The trace output has the following format: 

CCF6 4040 7F7F 2D00 0901 0005 0240 40C2 4003 -...1..aa. 

A B C D E F G ASCII image 

where: 

A is the beginning address of the buffer that was read. 

B is the controller address that was last polled or selected. This value is displayed twice. 

C is the terminal address or a general poll. A general poll is defined as terminal address 
> 7F. This value is also displayed twice. 

D is the enquiry (ENQ) poll command. 

E contains ramdom information unrelated to ICS operation. 

F contains the highest terminal address reserved for the ICS line in the right byte. 

G and the following two words of memory contain random information unrelated to ICS 
operation. 

ASCII image is the ASCII representation of the information contained in items B through G. This is 
not a valid representation for hexadecimal values less than >20 or greater than >7E. All values 
less than > 20 or greater than > 7E are shown as a period ( . ) 

If the values for B, C, and D are all zeros, ICS has received no polls since the last IPL. If B contains 
>3D, the last polled controller did not respond. If B, C, and D always contain the same poll or 
select address, either the host is polling only that controller or the line has stopped operation 
since the last poll was read. 
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4.6 CONTROLLER TASK 

When an ICS video or printer station is active, it sends the data it receives across the communica- 
tions line from the host directly to the device associated with the control unit address and ter- 
minal address during activation. The 3270 communications Device Service Routine (DSR) handles 
the link with the host. When receiving, the DSR reads the data link control characters, responds to 
selects, and routes the data to the controller task. The controller task then routes the data to the 
appropriate device. When sending, the DSR routes the data to the specified communications con- 
troller. The DSR for the ICS communications controller inserts the data link control characters and 
responds to the polls of the host. The controller task does not communicate with the host applica- 
tion programs. ICS stations generate or receive data from the host applications through the ICS 
controller task, the communications DSR, and the IBM-compatible front-end control unit. 

If the host selects an ICS terminal address when the terminal address is idle, the communications 
DSR acknowledges the select as if that station were active and ready to receive. When the host 
begins transmission, the controller task forwards the data to a local format file. During installa- 
tion you can specify whether you want the local format file feature. The following is the pathname 
template for local format files: 

.SSICS.CMxx.TMyy 

CMxx identifies the communications port name that ICS line uses, where xx is a two-digit decimal 
number. TMyy identifies the specific terminal address, where yy is a two-digit decimal number. 
Each terminal address has its own local format file. (Note that these files contain untranslated 
data from the host application.) The local format file is not a standard ASCII text edit file. It has a 
physical record size of 1920. If you attempt to look at a local format file by using the SCI procedure 
Show File (SF), the output displayed is not a true reflection of the contents of the file. The data is 
in EBCDIC form and contains IBM codes for commands, orders, and attribute characters. This 
data requires additional processing. The ICS printer, video station, and PSC tasks perform this 
processing. 

ICS uses the data link control procedures supported by the IBM 3271 Model 2 Control Unit. This 
protocol is a subset of the Binary Synchronous Communications (BSC) procedures described in 
Appendix F. 

Once activated, the controller task usually remains active until the next initial program load (IPL). 
ICS provides no utility for deactivating the controller task. Terminating the controller task does 
not save a significant amount of memory space, and few situations exist in which it is useful. 
Terminating the controller task is not recommended. Only under abnormal conditions, such as 
when it is in a tight loop, should you terminate the controller task. If the controller task detects a 
nonrecoverable error, it writes a message to the system logging device before it goes to its 
abnormal termination routine. 
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4.7 ICS VI DEO STATION 

The ICS display station emulates the IBM 3277 Model 2 and IBM 3278 Model 2 Display Stations. 
Every time an ICS video station is activated, the ICS video station task examines the local format 
file assigned to the activated terminal address. If there is any data in the local format file, ICS for- 
wards it to the specified video station. The local format file can be empty or contain one or more 
screens. These screens can be either from previous suspended transactions or from trans- 
missions that the host sent while the station was inactive. 

An option is available that switches the functions of the SKIP key. Skip is the unshifted function of 
the SKIP key. The skip function erases data from the cursor to the end of the field. The SKIP key is 
located between the RETURN and SHIFT keys, both of which are frequently used. Consequently, 
you can inadvertently erase data by pressing the SKIP key when intending to press RETURN or 
SHIFT. If you enable this option, such a mistake performs the tab function rather than a skip func- 
tion, and you do not lose any data. To enable this option, execute a Text Edit (XE) of the Execute 
Interactive Communications Terminal (XICT) command procedure, specifying .S$PROC.XICT as 
the file access name. The next to last line contains the parameters (enclosed in parentheses) used 
with the bid task primitive. Commas separate the parameters. Counting from the left, (beginning 
with one) the eighth parameter specifies whether this option is turned on or off. When you receive 
ICS, the eighth parameter is null. Change this to Y to specify on. After you replace the contents of 
the file with this modification, the tab function switches with the skip function. ICS displays no 
prompt for this option. 

4.8 ICS PRINTER STATION 

ICS emulates the operation of the IBM Model 2 3284, 3286, or 3287 Printer using one of the DX10- 
supported sequential input/output (I/O) devices or a sequential or relative record file. The ICS 
printer station provides a copy of information it receives from the application program executing 
at the host. 

When you specify a sequential file, relative record file, or sequential output device as the ICS 
printer station, the print operation is the same as that of a printer except that the data is written to 
a file or device Other than a printer. If the file you specify does not exist, ICS creates a sequential 
file that is not blank suppressed, providing that the directory in which the file will exist is acces- 
sible and not full. When the file or device is initially opened, it is opened with an open extend. The 
data from the host is appended to the file or device. When you terminate the station, ICS writes an 
end-of-file (EOF) to the file or the device. If you specify a file as the output pathname, you can dis- 
play the contents of that file using the SCI Show File (SF) command. To print a copy of a file used 
as the ICS printer station, use the SCI Print File (PF) command. 

4.8.1 Supported Printers 

The printers emulating IBM printers have a 1920-character buffer exactly as the ICS display sta- 
tion does. The character set emulated is the same as the ICS display station character set (refer to 
Appendix D). Therefore, all the characters that can be displayed on an ICS display station can be 
printed on the printer station. Certain printers are not able to print lowercase characters. 



2250954-9701 4-13 



Functional Description 



4.8.2 Printing Initiated by the Host Application Program 

The host application program can direct the printer station to print information that the host appli- 
cation transmits. To do this, the host program issues a 3270 Write command addressed to the 
printer station. This command is transparent to the operator. An intermediate buffer receives the 
data accompanying the Write command before the printer buffer receives it. The data is scanned 
and formatted according to a line-length specification in the Write command or according to 
printer orders that are embedded in the data. As each line is formatted, it is transferred to the 
printer buffer. 

4.8.3 Print Line Formatting 

The host application determines the format of the data it sends to the ICS printer station. The host 
application can embed printer orders in the data tocontrol the format or it can specify a line length 
to format the printed information. If printer data has no line length specified, it is unfor- 
matted. If printer data has a line length specified, it is formatted. 

Three printer orders may be used by the host application program to format the data: 

• New Line (NL) 

• Form Feed (FF) 

• End of Message (EM) 

The host application embeds the printer orders in the data stream. When the ICS printer station 
encounters the orders, it performs the formatting function. 

New Line (NL) Order. When the ICS printer station encounters an NL order in the data stream, it 
performs a carriage return and line feed before it continues to print. If the printer station reaches 
the end of the line before it encounters an NL order, it automatically performs a carriage return 
and line feed and continues to print. When the ICS printer station encounters an NL order in a 
nondisplay/nonprint field, it does not execute the order. Instead, it treats the NL order as an 
alphanumeric character and prints it as a blank (space). When the ICS station encounters an NL 
order in a printable field of a printout that has a line length specified, it does not execute the order. 
Instead, the ICS printer station prints it as a 5. 

Form Feed (FF) Order. When an ICS printer station encounters an FF order in the data stream, 
the printer station advances the paper to the top of the form. The printer station begins the print 
on this line. The ICS printer station prints the character position containing the FF order as a 
space. If the paper is located at the top of form when ICS encounters the FF order, the paper 
advances to the next top of form. This action results in a blank page. 

End of Message (EM) Order. The EM order indicates the end of the printout specified by the 
most recent Write command. ICS printer stations do not execute the EM order in the following 
situations: 

• When it is encountered in a nonprint/nondisplay field. Instead, the ICS printer station 
prints it as a space. 

• When the most recent Write command specified a line length for the printout. Instead, 
the ICS printer station prints it as a 9. 
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When ICS encounters an EM order, it performs a final line feed, terminates the printing operation, 
and ignores any further information in the buffer. The IC$ printer station does not perform the final 
line feed if the EM order is in the first position of a print line. 

Line Length Specification. A line length of 40, 64, or 80 characters can be specified in the Write 
command. If the Write command does not specify line length and embeds no printer orders, the 
ICS printer station prints 132 characters on each line. After the ICS printer station prints character 
132, it performs a carriage return and line feed. When the Write command specifies a line length, 
ICS writes the data from the intermediate buffer to the printer buffer with the specified line length. 
ICS then scans the data characters in the printer buffer one line at a time before it prints them. 
When a line contains one or more space characters only, a blank line is printed. When ICS encoun- 
ters null, alphanumeric, or attribute characters in nonprint fields, it prints them as spaces when 
printable characters appear in the same line. When the entire line is a nonprint field, ICS ignores 
the line; it does not generate a blank line. When ICS encounters a printer order in a line with a line 
length specification, ICS replaces it with a graphics character. For the printer order NL, the 
graphic character is 5. For EM, the graphic character is 9. ICS performs a line feed after it prints 
every line. When the Write command does not specify a line length, the embedded printer orders 
control the line length. 

4.8.4 Error Conditions 

A not-ready condition occurs when the printer station is out of paper or is mechanically disabled. 
The not-ready condition also occurs when ICS cannot access the file or sequential device acting 
as the printer station. If an ICS printer station is active when the host application program tries to 
select an ICS printer station, ICS directs the data from the host to the device identified by your 
response to the OUTPUT PATHNAME prompt. If this device is not ready or becomes not ready dur- 
ing the printing operation, ICS automatically retries the printout for a specified time interval. If the 
retry is successful, the printing continues; if the retry is not successful, the ICS printer station 
writes the current buffer onto the local format file for the terminal address in use, writes a mes- 
sage to the system log, and terminates. 

If you specify no local format file for the ICS line during installation and a time-out occurs, ICS 
discards the data. If you specify no local format file for the ICS line during installation and no ICS 
printer station is active when the host tries to select a printer on the line, ICS does not accept the 
select. 

If no printer station is active when the host application selects an ICS printer station, ICS accepts 
the select and writes the data from the host to the local format file. If for any reason ICS cannot 
access the local format file, it retries the write until the time-out interval has expired. 

The time-out interval is a function of a parameter within the Execute Interactive Communications 
Printer (XICT) command and the time-out value specified for the particular device during DX10 sys- 
tem generation (XGEN). The Release Information, DX10 3270 ICS describes how ICS determines 
the printer time-out interval. 

Other ICS error conditions, if detected by the printer station, also terminate the printer station. 
Appendix B describes the ICS error conditions. 



2250954-9701 4-15 



Functional Description 



4.9 LOCAL FORMAT FEATURE 

ICS operation includes an important optional feature, called local format, which provides you sev- 
eral extended capabilities. When you activate the ICS line and the host has data to send to an 
inactive terminal address, ICS accepts the data and directs it to the local format file allocated for 
that terminal address. If you do not select the local format option during installation, ICS does not 
accept data from the host for an inactive terminal address. When you activate an emulator at a 
CRT type terminal address, ICS first reads the local format file then it updates the screen with any 
data it saved. For a PRT type terminal address, ICS first reads the local format file then directs all 
the data to the OUTPUT PATHNAME before accepting data directly from the host. After ICS pro- 
cesses the data, the data is no longer available from the local format file. 

The local format file also preserves the screen image and cursor position when you press the sus- 
pend ICS function key to return to SCI. The ICS terminal address remains reserved for that station 
so that later, when you reactivate ICS at the same station, ICS redisplays the previous image. The 
cursor remains in the same position it occupied just before the ICS station was suspended. If you 
terminate the session using the < extended function> +Q key sequence, ICS does not save the 
screen image. When you terminate an emulator using the QICT SCI command, ICS saves the con- 
tents of the local format file. 

The local format file is also very important for the printer emulator when an unrecoverable error 
occurs. If you direct the printer emulator output to a printer and the printer runs out of paper, jams, 
or in some other way becomes inoperable, ICS retries the output for a user defined length of time 
(timeout) then writes the current print image to the local format file. If you did not select the local 
format option during installation, you lose the current print image. The Release Information, DX10 
3270 ICS provides instructions for modifying printer timeouts. 

The local format feature is also available to PSC applications. During installation, you can select 
the local format feature to make it available to all terminal addresses on a communications line. 
You specify this option for each ICS line that you install. If you install two ICS lines, you can define 
one with the local format feature and the other without the local format feature. The lines do not 
need to be the same. If you want to be able to suspend ICS without losing the contents of the 
screen, you should select the local format feature. 
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5.1 GENERAL DESCRIPTION 

The Programmed Station Control (PSC) facility in ICS enables an application program to serve as 
an ICS display or printer station. This section provides the systems programmer with a description 
of PSC routines, their capabilities, and how they work in a DX10 environment. The PSC software 
consists of a set of procedural language routines and an interface to ICS. The user-written 
program can perform input/output (I/O) across a 3270 line via ICS by calling the following routines: 

Open — Allows program access to an ICS station and line. 

Fill — Modifies data in the station buffer. 

Get — Retrieves data from the station buffer. 

Transmit — Sends modified data across the line to the host. 

Time-out — Waits for the host to reply. 

Retrieve Attributes — Retrieves field attribute information from the buffer. 

Close — Ends access to the 3270 line. 

PSC gives the application program many of the features of an ICS station, plus a number of addi- 
tional capabilities. A user-written PSC program emulates an ICS display or printer station. The 
program replaces the ICS station. The PSC program runs as a task under DNOS and exchanges 
data with the host application through ICS via the PSC Emulator as shown in Figure 5-1 . 

This section refers to the task that you write to emulate an ICS station as the PSC program or PSC 
task. Your PSC program calls the PSC routines that you link with your program. As shown in 
Figure 5-1, the interface between the PSC routines and the ICS controller task is called the PSC 
Emulator. 

PSC provides the user-written program with the following capabilities: 

• Control over station status and operation 

• Data transmission and reception along a 3270 line 

• Data buffering in the familiar display screen format 

• Manipulation of data in the screen buffer 

• Access to attribute information 
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*PSC TASK LINKED * 

*WITH USER-WRITTEN * 

* OBJECT MODULES AND * 

*PSC RUN-TIME MODULES * 



* USER- WRITTEN 

* OBJECT MODULE (S) 
BEGIN 



PSC CALLS 



END 



*PSC ROUTINE MODULES: 

OPEN 

GET 

FILL 

TRANSMIT 

RETRIEVE ATTRIBUTES 

TIME-OUT 

CLOSE 



32 70-COMPATIBLE 
HOST 



H 



COMMUNICATIONS 
LINE 



COMMUNICATIONS 
DEVICE SERVICE ROUTINE 



TRANSFER 
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ITC 



ICS CONTROLLER 
TASK 



CHANNEL 



SHARED 
PROCEDURE 



ICSPSC TASK 
(PSC EMULATOR) 
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Figure 5-1. PSC Overview 



Operating by itself, a PSC program can take over any repetitive task usually performed by a station 
operator. The program receives screens from the host, modifies them as necessary, transmits 
them back along the ICS line, and waitsfor the host to reply. At the same time, the PSC program 
enjoys all the facilities provided by DX10 for using files, devices, and utilities. By coupling the PSC 
program with user-written interfaces to data entry devices, the programmer can often enhance the 
performance of an application. The PSC program can obtain data from one or more data entry 
stations, check for entry errors, and transmit the data to the host. By detecting errors before the 
data goes to the host, the program reduces traffic along the communications link. 

This section provides the application programmer with the information needed to write a program 
employing the PSC routines. The discussion of program requirements provides essential back- 
ground information on the data structures used in a PSC program. Next, the discussion deals with 
the routines that enable the PSC program to emulate an ICS station. This includes the calling 
syntax in COBOL, FORTRAN, Pascal, and DS990 assembly language, as well as examples. The 
section concludes with directions for linking, patching, and executing PSC programs. 

The discussions assume the reader has a programming knowledge of COBOL, FORTRAN, Pascal, 
or DS990 assembly language. For descriptions of these languages and details on their implemen- 
tation under DNOS, consult their programmer's guides and reference manuals. It is also assumed 
that the programmer understands the structure and requirements of the host application that 
works with the PSC program. 
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5.2 PSC PROGRAM REQUIREMENTS 

The PSC routines pass data between the PSC program and a host application. The following para- 
graphs describe the structures and characteristics of the data exchanged, indicating how the 
program should handle the data. 

Using the PSC routines requires setting up the variables that become arguments. This involves 
declaring them at the appropriate part of the program and supplying them with values before call- 
ing them. Paragraphs 5.4.1 through 5.4.4 show the arguments for the routines, along with their 
data types, lengths, valid values, and uses in each of the programming languages— COBOL, 
FORTRAN, Pascal, and 990 assembly language. 

The following paragraphs describe the data structures used by the PSC program and suggest 
ways to declare them in each of the languages. Beyond declaring the arguments and providing 
their values, all that remains is to follow the requirements of the programming language for call- 
ing an external routine. 

When you activate the PSC program, it does not have access to the ICS line until it issues an Open 
call. If the Open call succeeds, the program can then transmit something to the host, call the 
Time-out routine to wait for the host to respond, and issue a Get call to obtain a reply. PSC pro- 
grams emulating printer stations can only receive data. The message and reply appear in the sta- 
tion buffer, exactly as the data passes between the host and a device serving as an ICS station. 

5.2.1 PSC Station Buffers 

The PSC program controls a station by manipulating its buffer. The buffer holds up to 1920 charac- 
ters, representing the screen of an ICS display or printer station. The PSC program fills the buffer, 
retrieves data from it, and transmits the data to the host application. 

Buffer operations address data by field and position. Fields are numbered sequentially from the 
top line of the screen to the bottom and from left to right on each line. The screen buffer begins 
with the first position on line 1 and ends with the last position on line 24— an array of 1920 buffer 
addresses. Addresses range from through 1919, and each address holds either a data character 
or an attribute character. (PSC treats nulls as data characters.) The PSC program that calls the Get 
or Fill commands needs its own buffer large enough to hold the largest field retrieved or modified. 
Since field sizes range from a few characters to the entire 1920-character buffer, the program 
buffer can be quite small or large, depending on the host application. 

• COBOL — The buffer can be either a single DISPLAY data item with a picture large 
enough to hold the largest field, a group item with subitems for each field, or an array 
with enough word-sized data items to hold each of the characters. 

• FORTRAN — The buffer can be a one-dimensional integer array large enough to hold 
the largest field. 

• Pascal — The buffer can be a string (packed array) with either a dynamic index or a 
static index large enough for the largest field. 

• 990 assembly language — The buffer should be a block of words large enough to hold 
the largest field. 
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5.2.2 Attribute Data 

Three of the PSC routines provide access to attribute information from the station buffer. The Fill 
and Get routines return as the eighth argument (<a8>) the attribute character of the field modi- 
fied or retrieved. The Attribute routine returns the attributes of up to 40 fields in a special attribute 
buffer. Your program reads the attribute character to determine the structure of the data. Your 
program cannot modify the attribute character. 



NOTE 

In this manual, the notation <a1> signifies the first argument, 
< a2> signifies the second argument, < a3> the third, and so on. 



5.2.2.1 Attribute Argument Returned by Fill and Get Routines. The attribute information 
returned by Fill and Get routines arrives as two words as shown in Figure 5-2. The high-order byte 
of the first word contains the attribute character for the field. The low-order byte of the first word 
and both bytes of the second word are reserved for future enhancements and contain no informa- 
tion of use to the program. 

The attribute character has the following bit pattern: 



Bit 


1 
2 
3 
4-5 



Description 

Not used (depends on values for bits 2 through 7) 

Always 1 

Protection^ = unprotected, 1 = protected; cannot be modified) 

Contents (0 = alphanumeric, 1 = numeric) 

Variable meaning as shown: 



Value 

00 
01 
10 

1 1 

Always (not used) 

Modification^ = unmodified,! = modified) 



Meaning 

Display 
Display 
Display 
Non-display/non-print 
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byte 1 



BYTE 2 



WORD 1 
WORD 2 



ATTRIBUTE 


UNUSED 


UNUSED 


UNUSED 
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Figure 5-2. Attribute Argument 



To access the attribute information returned, the calling program needs an appropriate data struc- 
ture to use for the eighth argument of the call. The data structure used must reserve two words of 
memory (four bytes). If the PSC program reserves only one byte for the attribute argument, the PSC 
attribute call writes over the next three bytes in memory when it returns the eighth argument. The 
following list suggests data structures that each language can use for the attribute argument. 

• COBOL — Synchronized block of two COMP 4 data items, allowing the attribute infor- 
mation to be extracted using binary arithmetic from the first data item. COMP 4 is a 
binary structure. 

• FORTRAN — One-dimensional integer array with two elements. 

• Pascal — Array of 32 Boolean variables, allowing attribute information to be extracted 
from the first eight bits. 

• 990 assembly language — Four bytes beginning on an even word boundary, allowing 
attribute information to be extracted from the first byte. 

5.2.2.2 Attribute List Returned by Retrieve Attributes. The attribute information returned by 
the Retrieve Attributes routine arrives in up to 120 words (or 240 characters), using three words to 
describe each field. As shown in Figure 5-3, the second and third words for each field contain the 
same information as returned in the eighth arguments of the Fill and Get routines. The first word 
gives the buffer address of the beginning of the field, a decimal number in the range through 
1919. 
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WORD 1 

WORD 2 

WORD 3 

WORD 4 



BYTE 1 


BYTE 2 


BUFFER ADDRESS FOR BEGINNING OF FIELD 


ATTRIBUTE 


UNUSED 


UNUSED 


UNUSED 



> FIRST 

REQUESTED 
FIELD 



BEGINNING BUFFER ADDRESS OF NEXT FIELD 
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Figure 5-3. Attribute List 



The location of the attribute character is one less than the beginning of the field except for a field 
that begins in location 0. The unformatted screen is treated as a 1920-character field beginning at 
location and having alphanumeric, unprotected, and display attributes. On a formatted screen, a 
field beginning at location has its attribute character at location 1919. 



NOTE 

In this manual, the right angle bracket (>) preceding a value 
indicates that it is a hexadecimal number. 



5.2.3 Host Application Commands and Orders 

Except for three printer orders, the PSC Emulator reads and interprets IBM commands and orders 
that the host sends. The PSC programmer who designs a program to serve as a PSC video station 
(type CRT) need not be concerned with these orders because the 3270-host transmits these 
embedded orders only to printer stations. A PSC program does not need to process the buffer con- 
trol orders since the PSC Emulator translates them automatically. By the time the program gets 
control after data comes from the host, the data already occupies the correct field positions. The 
PSC Emulator helps in this by handling the I/O between the station and the host, executing com- 
mands, and manipulating transmission as needed. A PSC program has to take charge of handling 
the information that arrives at the station. 
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The PSC Emulator removes the command code that the host sends from the data system and per- 
forms the operation indicated. The write control character (WCC) is passed to the PSC program as 
an argument for the Retrieve Attributes routine. Bits 2 and 3 are of particular importance to a 
printer PSC program because they determine the print line length. The following WCC bit pattern 
and associated operations are as follows: 



Bit 


Meaning 





Determined by contents of bits 2-7 


1 


WCC reset bit. Always 1. 


2-3 


Print Line Length. 



The NLand EM orders in data stream determine the print line 
length; or the default is 132 character line. 

00 = 132-characterline 

01 = 40-character line 

10 = 64-character line 

11 = 80-characterline 

Start Printer. 

= Do not start printer. 

1 = Start printer at end of write. 

Sound Alarm. 

= Do not sound alarm. 

1 = Sound alarm at end of write. 

Reset Keyboard. 

= Do not reset. 

1 = Reset keyboard. Restore operation of the keyboard 

locked by input inhibited condition. 

Reset Modified. 

= Do not reset. 

1 = Reset all MDT (Modified Data Tag) bits in the selected 

device's existing buffer data before word and data is 
written or orders are executed. 
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Before it returns control to the PSC program, the PSC emulator carries out orders embedded in the 
transmitted data, but it does not translate the following three printer orders: 

EBCDIC 
Code Order Description 

>15 NL New Line — Used for printouts with no line lengths specified. The 

ASCII equivalent for the NL order is the Line Feed character, >0A. 

> OC FF Form Feed — Used at the beginning of a printed line to index the form 

vertically. Some applications may require that the FF order be 
replaced by the ASCII Vertical Tab order, > OB. 

>19 EM End of Message — Terminates printouts with no line lengths speci- 

fied. The ASCII equivalent for this order is >13. Some applications 
may require that the EM order be replaced by the ASCII Form Feed 
order, >0c. 

These orders are not translated so that the PSC program can choose how to handle them. The PSC 
program can recognize them by their EBCDIC values: >15, >0C, and > 19. If the program performs 
its own printer I/O, it can either replace the orders in the buffer with the appropriate ASCII codes or 
translate them to print as blanks. The NL order marks the end of a line and needs to be replaced by 
a Line Feed character (>0A) before the message goes to the printer unless the PSC program 
handles line breaks itself. The FF order causes printing to resume at a predetermined line and 
needs to be replaced by an ASCI I Vertical Tab character ( > OB). The EM order marks the end of the 
message and can be replaced by a Form Feed (>0C) to advance to the next page or a Deselect 
character (>13) to terminate the printer operation. The PSC Emulator fills the rest of the station 
buffer with nulls when it detects the EM order. 

If you write your PSC program in COBOL, FORTRAN, or Pascal, you cannot directly replace these 
printer orders with ASCII equivalents. You must consider how the language that your program 
uses handles output to whatever device your program uses. 

5.2.4 ICS Station Selection 

Every call to a PSC routine specifies the control unit address of the ICS line and the terminal 
address of the station emulated. In each PSC routine, the first argument <a1> consists of two 
words containing these addresses or a specification for auto-select. Only the Open routine 
selects addresses automatically. The other routines use the addresses that the Open routine 
selects. The first word contains three flags that specify whether to use the local format file and 
either the IBM control unit address, the device name, or a specification for auto-select. The sec- 
ond word contains the device type and either the terminal address or a specification that ICS 
select an available address. 
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5.2.4.1 First Word. The PSC Emulator treats the first word of this argument as two separate 
bytes as shown in Figure 5-4. Bit 7 designates the least significant byte, and bit zero designates 
the most significant byte. The first byte contains three flags that specify the following options: 

• Use or do not use the local format file. 

• Identifies the type of value to be found in byte two. 

• Automatically select a control unit address. 

Bit 5 is the flag specifying whether to use the local format file. If bit 5 is a one, the PSC Emulator 
stores the contents of the local format file for the terminal address used into the station buffer 
when the Open is performed. If this bit is zero, the local format file is not used and the station 
buffer is cleared to nulls after the Open is performed. 

Bit 6 indicates whether ICS automatically selects the communications line or uses the value in the 
second byte. One indicates auto-select. Zero indicates that ICS uses the value found in the sec- 
ond byte. 

Usually, if the program uses auto-select for the communications line, it also uses auto-select for 
the terminal address. If the program specifies auto-select for both, ICS searches for the first avail- 
able active communications line that has an available terminal address of the appropriate type. 

If the program specifies auto-select for the communications line but specifies a particular ter- 
minal address, ICS selects the first available active line at which the specified terminal address of 
the specified type (see second word) is available. 

Bit 7 of the first byte contains a flag indicating to ICS the kind of value in the second byte. Zero in 
bit 7 indicates that the value in the second byte contains a decimal control unit address. One indi- 
cates that the second byte contains the numerical portion of the communications line name or, if 
the second byte contains a zero, that ICS selects the first available communications line. 

The second byte is either a decimal control unit address, the numerical portion of the communica- 
tions line name, or a zero for automatic selection. You can use any one to identify the communica- 
tions controller port (communications line name), the communications line, and consequently, the 
host. 

Valid control unit addresses range in value from through 31. ICS maps this decimal value to an 
EBCDIC IBM control unit address according to Table 2-1. 

The communications line name address is the numerical portion of the device name for a commu- 
nications device. For example, CM03 is identified as 03. If bit 7 of byte 1 is a one and byte 2 
contains a zero, ICS selects the first available communications line. 
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BYTE t BYTE 2 

12 3 4 5 6 7 (BIT POSITION) 1 2 3 4 5 6 7 



CONTROL UNIT ADDRESS OR 
COMMUNICATIONS LINE NAME 
(0 SPECIFIES AUTO-SELECT A 
COMMUNICATIONS LINE NAME) 



-0 INDICATES ADDRESS IS A CONTROL UNIT ADDRESS (DECIMAL) 

1 INDICATES ADDRESS IS A COMMUNICATIONS LINE NAME 
(OR AUTO-SELECT IF BYTE 2 IS 0) 



INDICATES USE THE VALUE IN BYTE 2 

1 SPECIFIES AUTO-SELECT A CONTROL UNIT ADDRESS 

SPECIFIES DO NOT USE LOCAL FORMAT FILE 

1 SPECIFIES PUT THE CONTENTS OF THE LOCAL FORMAT FILE 
IN THE STATION BUFFER 
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Figure 5-4. Word One of the First Argument 



5.2.4.2 Second Word. As with the first word of this argument, ICS treats the second word as 
two separate bytes. As shown in Figure 5-5, the first byte contains two flags. Bit 6 contains the 
flag that designates whether ICS makes the device selection or uses the terminal address in the 
second byte. Bit 7 contains the second flag that specifies the terminal type, either video station 
(CRT) or printer station (PRT). The PSC Emulator examines only bit 7 of the second word if bit 6 is 
set to one. 

The second byte contains the terminal address that ICS maps to an IBM EBCDIC address. Like the 
communications line address, ICS maps the terminal address according to Table 2-1 . 

When the PSC program calls the Open routine, it opens the ICS terminal address on a communica- 
tions line. The terminal address stays open until the program calls the Close routine. Between the 
Open and Close calls, the PSC Emulator uses the ICS station to exchange data with the host via 
ICS. 

The terminal address is one of the addresses reserved during ICS generation. ICS can select the 
terminal address automatically as it can when activating a physical ICS station. A one in bit 6 of 
the first byte of the second word in < a1> specifies to ICS that it is to make the terminal address 
selection of the type specified in bit 7 of the same byte. If your program specifies auto-select, 
upon successful activation of the terminal address the PSC Emulator returns the control unit and 
terminal addresses that it has selected in<a1>. A zero in bit 6 specifies that the terminal address 
to be used is in the second byte of the second word of < a1> . 
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BYTE 1 






1 


2 


3 


4 


5 


€ 






7 





























(BIT POSITION) 



BYTE 2 
2 3 4 5 



TERMINAL ADDRESS 



INDICATES A CRT TYPE DEVICE 

1 INDICATES A PRT TYPE DEVICE 

INDICATES THAT THE ADDRESS IS SPECIFIED IN BYTE 2 

1 SPECIFIES THAT THE TASK SELECTS THE NEXT AVAILABLE 
TERMINAL ADDRESS OF THE TYPE SPECIFIED (CRT OR PRT) 
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Figure 5-5. Second Word of First Argument 



The PSC program can emulate either an ICS display or printer station. The type indicator bit is the 
least significant bit of the high-order byte in the second word of < a1> . Zero indicates a display 
station. One indicates a printer station. 



NOTE 

A user-written PSC application can open only one ICS terminal 
address at a given time. Your application can use more than one 
ICS terminal address, but it must close the first one before it can 
open the second. 



The following are suggestions for each supported programming language for the data structures 
your program can use for the first argument: 

• COBOL— Data group consisting of two COMP-1 data items 

• FORTRAN — A one-dimensional integer array with two elements 

• Pascal — Address data type consisting of four byte-sized variables 

• 990 assembly language — Four bytes of data 
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5.2.5 Completion Codes 

PSC routines return completion codes that report the success or failure of their operations. A zero 
completion code always indicates success, while nonzero codes indicate error conditions. Ap- 
pendix B lists all the completion codes for PSC, along with an explanation of the condition. The 
PSC program should test the condition code from a routine immediately after the call. Since most 
PSC errors are not recorded in the system log or elsewhere, the program should at least record the 
station address and completion code as part of its error-handling routine. If a nonrecoverable error 
occurs, the abnormal exit routine of the PSC program should record these values and always 
issue a Close call to PSC. 

Some errors returned to video stations and the system log are identified as PSC errors by their pre- 
fix, *XPSC. The DX10 System Command Interpreter (SCI) actually detects and reports these errors. 
They usually occur when a bad parameter is entered in response to one of the prompts. The first 
paragraph of Appendix B explains these messages. 

5.3 PSC ROUTINES 

The following paragraphs discuss the PSC routines individually. This discussion explains how the 
PSC routines control the flow of information between the station and the host. These routines 
enable a program to open and close stations, read and write data to the station buffer, and send 
and receive data from the host application. 

The description of a routine consists of the following five parts: 

Name of the routine and a brief functional description 

Syntax for calling the routine from COBOL, FORTRAN, Pascal, and 990 assembly 
language programs 

Description of each argument 

Explanation of the results of the call 

Examples in COBOL, FORTRAN, Pascal, and 990 assembly language 

Language-specific portions of the description are labeled to avoid confusion. The call statements 
show symbolic arguments enclosed in angle brackets (< >). In actual programs, however, suit- 
able programming language variables replace the symbolic arguments, as shown in the examples 
presented for each call. Paragraphs 5.4.1 through 5.4.4 provide capsule descriptions of the argu- 
ments for each routine called in each programming language. 



NOTE 

Some of the routines have dummy arguments that preserve compat- 
ibility with other PSC implementations. You must reserve memory 
space for these arguments in the calls, but you need not supply any 
values. 
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5.3.1 Open Routine — Open Station for PSC Use 

The Open routine requests exclusive access to an ICS station and sets its initial mode of opera- 
tion. This call is always required before your program can call any other PSC routine. If the user- 
written task is bid from the Execute Programmed Station Control (XPSC) command procedure, the 
station specified by the Open routine is already active, and in order to avoid an error, < a2> should 
specify Do not activate. If the user-written PSC task is not bid by XPSC, < a2> of the Open routine 
must specify Activate. Figure 5-6 contrasts the program flow of a PSC program activated by XPSC 
with that of a PSC program activated by one of the language activation procedures. 

The Close routine uses the same kind of first argument to specify Terminate or Do not terminate. 
(See paragraph 5.3.7). Most applications can use either method. Paragraph 5.4 contrasts both 
methods and discusses the merits of each. 





SCI 






























XPSC 




LANGUAGE ACTIVATION 
PROCEDURE 




















ICSPSC 
(PSC EMULATOR) 










PSC TASK 

OPEN 

ACTIVATE 








USER- WRITTEN 
PSC TASK 










OP 


EN- 
ACT 


-DO N 
I VAT! 


IOT 




ICSPSC 
(PSC EMULATOR) 



2281819 



Figure 5-6. PSC Activation Flow 
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5.3.1.1 Open Call Statements. The following examples demonstrate the Open call statement 
in each of the supported programming languages. 

COBOL: 

CALL "IC$OPN" USING < a1>< a2>< a3>< a4> . 
FORTRAN: 

CALL IFSOPN (< a1> ,< a2> ,< a3> ,< a4>) 
Pascal: 

IFSOPN (< a1> ,< a2> ,< a3> ,< a4>); 

990 Assembly Language: 

LI R0,ARGLST POINTER TO ARGUMENT LIST 

BLWP @IC$OPN SUBROUTINE LINKAGE 



ARGLST 


DATA 


4*2 




DATA 


<a1> 




DATA 


<a2> 




DATA 


<a3> 




DATA 


<a4> 



FOUR TWO-BYTE POINTERS TO ARGUMENTS 
COMMLINE&TERMINALID POINTER 
ACTIVATE FLAG POINTER 
NOT USED, DUMMY POINTER 
COMPLETION CODE POINTER 



5.3.1.2 Arguments for the Open Routine. 

Open routine: 



The following list describes the arguments for the 



<a1 > is the control unit and terminal addresses of the PSC program. This argument con- 
sist of two words. The first word contains the control unit address or a specifica- 
tion to let ICS choose the control unit address. It also contains a flag that indicates 
whether PSC fills the station buffer with the contents of the local format file. The 
second word contains the terminal address or a specification to let ICS choose the 
terminal address. It also specifies the type (CRT or PRT) of the terminal address. 
Paragraph 5.2.4 describes this argument in detail. 

<a2> Indicates whether to activate the station, as follows: 

= The station is already active, so do not attempt to activate it. Use this 

when the users task is activated with the XPSC command or when the 
station was previously closed with the do not terminate option (see para- 
graph 5.3.7). 

1 = Activate the station. 
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< a3> is a dummy argument, not used by the routine but required for compatibility with 

previous releases." 

<a4> is a completion code. The routine returns a zero completion code when the 

operation succeeds. For nonzero codes, see Appendix B. 

5.3.1.3 Results of the Open. A successful call to the Open routine makes the ICS communica- 
tions line and terminal address available to the PSC program. The value of the second argument 
determines whether the routine attempts to activate the PSC Emulator. Zero indicates that the 
PSC Emulator is already active and requires no further action. One indicates that the PSC Emula- 
tor is to be activated. After a successful call to the Open routine, the program can send and 
receive data across the ICS line by issuing calls to other PSC routines. 

If <a1> specifies auto-select, the PSC Emulator returns the control unit and terminal addresses 
selected in < a1> . The only other argument that the PSC Emulator returns is < a4> . The second 
and third arguments are not changed. Be sure and check the return code and handle any detected 
errors. 

If the XPSC command procedure bids the user-written task, you should specify Do not activate 
when calling the Open routine by assigning < a2> a value of zero. If you activate your PSC pro- 
gram by using XPSC and enter a null value in response to the COMMUNICATIONS LINE NAME 
and TERMINAL ADDRESS prompts to let ICS choose the communications line and terminal 
address, you should also specify auto-select in <a1> when your PSC program calls the Open 
routine. 

5.3.1.4 Examples of the Open Call. The following examples demonstrate the Open call state- 
ment in each of the supported programming languages. 

COBOL: 

CALL "IC$OPN" USING STATION-ADDRESS ACTIVATE DUMMY COMPLETION-KODE. 
FORTRAN: 

CALL IFSOPN (STADDR, OPNACT, OPNDUM, CCODE) 
Pascal: 

IFSOPN (ADDR, ACTIVATE, DUMMY, CCODE); 
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990 Assembly Language: 



LI 
BLWP 



R0,OPNARG 
@IC$OPN 



POINTER TO ARGUMENT LIST 
SUBROUTINE LINKAGE 



OPNARG 



DATA 4*2 

DATA OPN1 

DATA OPN2 

DATA OPN3 

DATA OPNCC 



FOUR TWO-BYTE POINTERS TO ARGUMENTS 
COMM LINE &TERMINAL ID POINTER 
ACTIVATE FLAG POINTER 
DUMMY POINTER; DUMMY IS NOT USED 
COMPLETION CODE POINTER 



OPN1 


DATA 


>0200 




DATA 


>0200 


OPN2 


DATA 





OPN3 


DATA 





OPNCC 


BSS 


2 



LET ICS SELECT THE COMM LINE 

LET ICS SELECT A TERMINAL ADDRESS OF 

THE CRT TYPE 

DO NOT ACTIVATE 

DUMMY; NOT USED 

COMPLETION CODE 



5.3.2 Fill Routine — Fill Station Buffer 

This routine places ASCII data into a specified field of a program buffer. The call indicates how 
many characters go to the buffer, which field receives them, where they go in the field, and what 
happens next to the buffer. The arguments returned indicate the length of the fill, the success of 
the operation, and the attributes of the field to be filled. 
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5.3.2.1 Fill Call Statements. The following examples demonstrate the Fill call statement in 
each of the supported programming languages. 

COBOL: 

CALL "IC$FIL" USING < a1> ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> . 
FORTRAN: 

CALL IFSFIL (< a1> ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> ) 
Pascal: 

I FSFI L (< a1 > ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> ); 

990 Assembly Language: 

LI R0,FILARG POINTER TO ARGUMENTS LIST 

BLWP @IC$FIL SUBROUTINE LINKAGE 



FILARG 



DATA 


8*2 


DATA 


<a1> 


DATA 


<a2> 


DATA 


<a3> 


DATA 


<a4> 


DATA 


<a5> 


DATA 


<a6> 


DATA 


<a7> 


DATA 


<a8> 



5.3.2.2 Arguments for the Fill Routine. 

routine: 



EIGHT TWO-BYTE POINTERS TO ARGUMENTS 
COMM LINE & TERMINAL ID POINTER 
PROGRAM STATION BUFFER POINTER 
LENGTH OF DATA TO FILL POINTER 
FIELD NUMBER POINTER 
POSITION WITHIN THE FIELD POINTER 
NEXT ACTION POINTER 
COMPLETION CODE POINTER 
ATTRIBUTE POINTER 

The following list describes the arguments for the Fill 



< a1> is the control unit and terminal addresses of the PSC program. This argument con- 

sists of two words. The first word contains the control unit address or a specifica- 
tion to let ICS choose the control unit address. It also contains a flag that indicates 
whether PSC fills the station buffer with the contents of the local format file. The 
second word contains the terminal address or a specification to let ICS choose the 
terminal address. It also specifies the type (CRT or PRT) of the terminal address. 
Paragraph 5.2.4 describes this argument in detail. 

< a2> is the name of the buffer in the PSC program that holds the fill data. This argument 

must be an alphanumeric data type and must start on an even address boundary. 

< a3> is the length of the fill data in characters. This number must be no greater than the 

length of the field filled and no more than 240 characters in any case. 

<a4> is the number of the field to be filled, counting from the beginning of the station 
buffer. 
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< a5> is the position in the field where the fill starts. The fill begins at this character loca- 

tion in the designated field, counting from the first position after the attribute char- 
acter. The first position is one. 

< a6> is an indicator for the action to follow the fill operation, as follows: 

0= No otheraction is required. 

1 = Transmit any modified data of the program buffer to the host. If the terminal 
address used by the PSC program is the PRT (printer) type, ICS transmits a message 
to the host that indicates the host can send more data. 

3 = Clear all unprotected fields in the program buffer. If this is specified, <a2> 
through <a5> are ignored, and the attribute byte of the first unprotected field is 
returned in <a8>. 

< a7> is a completion code returned after the fill. Zero indicates success. Nonzero comple- 

tion codes indicate an error condition. If the PSC Emulator detects an error, it does 
not modify the station buffer. Refer to Appendix B. 

< a8> is the attribute information for the field. This argument consists of two words. The 

high-order byte of the first word returns the attribute byte for the field filled. The low- 
order byte of the first word and both bytes of the second word are reserved for future 
enhancements. If clear (option three of < a6>) is specified, the attribute byte of the 
first unprotected field is returned in < a8> . 

5.3.2.3 Results of the Fill. Calling the Fill routine sends the fill data to the station buffer. The 
data goes into the designated field and starts at the designated position. This modifies the field, 
and the host application receives the data on the next transmission. If the fill data overflows the 
field, the remainder is not used. If the fill data is exhausted before the field is full, the PSC 
Emulator does not modify the remainder of the field. 

The Fill routine returns four values of interest: 

• The third argument indicates the length of the data filled. You can use this value to 
check the success of the operation. 

• The fifth argument indicates the position in the field where the fill stopped. If the fill 
data exactly reaches the end of the field, a 1 is returned. If the fill data goes beyond the 
field, a 2 is returned. Neither of these conditions cause a nonzero completion code to be 
returned in the seventh argument. 



• 



The seventh argument returns a completion code for the operation with zero indicating 
success and nonzero codes (listed in Appendix B) indicating error conditions. 

The eighth argument returns with the attribute byte for the field filled as the high-order 
byte in the first word. Refer to paragraph 5.2.2. 
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5.3.2.4 Examples of the Fill Call. The following examples demonstrate the Fill call statement 
in each of the supported programming languages. 

COBOL: 

CALL "IC$FIL" USING STATION-ADDRESS FILL-BUFFER FILL-HOW-MANY FILL-FIELD 
FILL-BEGIN FILL-ACTION COMPLETION-KODE FILL- ATTRIBUTE 

FORTRAN: 

CALLIFSFIL(STADDR,BUFFER,FILLEN,FILFLD,FIL1,FILACT,CCODE,FILATR) 

Pascal: 

IFSFIL(ADDR,B,FILI COUNT,FILL_FIELD,FILL_START,FILl ACTION, 

CCODE.ATTR); 

990 Assembly Language: 

LI R0,FILARG POINTER TO ARGUMENTS LIST 

BLWP @IC$FIL SUBROUTINE LINKAGE 



FILARG 


DATA 


8*2 




DATA 


OPN1 




DATA 


FIL2 




DATA 


FIL3 




DATA 


FIL4 




DATA 


FIL5 




DATA 


FIL6 




DATA 


FILCC 




DATA 


FIL8 


OPN1 


DATA 


>0200 




DATA 


>0200 


FIL2 


BSS 


2 


FIL3 


BSS 


2 


FIL4 


BSS 


2 


FIL5 


BSS 


2 


FIL6 


BSS 


2 


FILCC 


BSS 


2 


FIL8 


BSS 


2 




DATA 






EIGHT 2-BYTE POINTERS TO ARGUMENTS 
COMM LINE & TERMINAL ID POINTER 
PROGRAM STATION BUFFER POINTER 
DATA LENGTH POINTER 
FIELD NUMBER POINTER 
START POSITION POINTER 
NEXT ACTION POINTER 
COMPLETION CODE POINTER 
ATTRIBUTE POINTER 



USE THE SAME AS USED FOR THE OPEN 

ROUTINE; AUTOMATICALLY SELECT 

CRT TYPE 

BEGINNING OF STATION BUFFER 

LENGTH OF THE DATA TO FILL 

FIRST FIELD TO FILL 

POSITION WITHIN THE FIELD TO 

BEGIN FILL 

ACTION TO FOLLOW 

COMPLETION CODE 

FIRST WORD OF ATTRIBUTE ARGUMENT 

2ND WORD OF ATTRIBUTE; NOT USED 
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5.3.3 Get Routine — Get Data From the Station Buffer 

The Get routine enables the PSC program to retrieve information from a station buffer. The pro- 
gram specifies which field, where in the field to begin, and how many characters to retrieve. The 
routine returns the field specified, the number of characters retrieved, a completion code, and the 
attributes of the field. 

5.3.3.1 Get Call Statements. The following examples demonstrate the Get call statement in 
each of the supported programming languages. 

COBOL: 

CALL "IC$GET" USING < a1>< a2>< a3> < a4> < a5> < a6> < a7> < a8> . 
FORTRAN: 

CALL I FSG ET (< a1 > ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> ) 
Pascal: 

IFSGET (< a1> ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> ); 

990 Assembly Language: 

LI R0,GETARG POINTER TO ARGUMENTS LIST 

BLWP @IC$GET SUBROUTINE LINKAGE 



GETARG DATA 


8*2 


DATA 


<a1> 


DATA 


<a2> 


DATA 


<a3> 


DATA 


<a4> 


DATA 


<a5> 


DATA 


<a6> 


DATA 


<a7> 


DATA 


<a8> 



EIGHT TWO-BYTE POINTERS TO ARGUMENTS 
COMM LINE & TERMINAL ID POINTER 
PROGRAM STATION BUFFER POINTER 
DATA LENGTH POINTER 
FIRST FIELD POINTER 
START POSITION POINTER 
NEXT ACTION POINTER 
COMPLETION CODE POINTER 
ATTRIBUTE POINTER 
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5.3.3.2 Arguments for the Get Routine. The following list describes the arguments for the Get 
routine: 

< a1> is the control unit and terminal addresses of the PSC program. This argument con- 

sist of two words. The first word contains the control unit address or a specification 
to let ICS choose the control unit address. It also contains a flag that indicates 
whether PSC fills the station buffer with the contents of the local format file. The 
second word contains the terminal address or a specification to let ICS choose the 
terminal address. It also specifies the type (CRT or PRT) of the terminal address. 
Paragraph 5.2.4 describes this argument in detail. 

< a2> is the name of the buffer in the PSC program to receive the data. The value for < a2> 

must an alphanumeric data type and must begin on an even address boundary. 

< a3> is the length of the data retrieved. This value determines the number of characters 

that the routine copies from the station buffer into the program buffer indicated by 
< a2> . The value supplied should be no greater than the size of the buffer receiving 
the data and in any case no more than 240 characters. Fields that contain more than 
240 characters require successive Get calls. 

< a4> is the number of the first field containing the data to retrieve, counting from the first 

field in the station buffer. 

< a5> is the position where the retrieval begins. This number tells the Get routine where to 

start retrieving data in the field that the fourth argument indicates. Each field begins 
counting with one (not a buffer position). 

< a6> is an indicator for the action to follow the Get operation, as follows: 

= No action is required. 

1 = Transmit the station buffer to the host. If the terminal address used by the 

PSC program is the PRT (printer) type, ICS transmits a device end to the host 
and no data is transmitted. 

3 = Clear all unprotected fields in the station buffer. 

<a7> is the completion code returned after the Get. Zero indicates success. Nonzero 
completion codes indicate an error condition. Refer to Appendix B. 

<a8> is the attribute information for the field retrieved. This argument consists of two 
words. The high-order byte of the first word returns the attribute byte for the field. 
The low-order byte of the first word and both bytes of the second word are reserved 
for future enhancements. 
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5.3.3.3 Results of the Get. The Get routine attempts to retrieve data from a specified station, 
field, and position. The operation succeeds when the field contains data at the specified position. 
The program buffer indicated by < a2> receives the data so that the program can work on it. 

Four of the arguments return values of interest, as follows: 

• The third argument indicates the length of the data retrieved. You can use this value to 
check the success of the operation. 

• The fifth argument indicates the position in the field where the retrieval stopped. If posi- 
tive, it represents the position after the last character retrieved. This is the position 
where the next retrieval begins when the program retrieves more of the field. If the fifth 
argument returns -1, it means the last character retrieved is the last character in the 
field. If the fifth argument returns -2, the routine came to the end of the field before it 
retrieved all of the characters requested. 

• The seventh argument returns a completion code back to the PSC program. Zero 
indicates success. Nonzero completion codes indicate an error condition. Refer to 
Appendix B. In particular, a >0D code indicates that no new data is available for 
retrieval. 



• 



The eighth argument returns the attribute byte for the field that was retrieved as the 
high-order byte in the first word. Refer to paragraph 5.2.2. 



5.3.3.4 Examples of the Get Call. The following examples demonstrate the Get call statement 
in each of the supported programming languages. 

COBOL: 

CALL "IC$GET" USING STATION-ADDRESS GET-BUFFER GET- HOW- MANY GET-FIELD 
GET-BEGIN GET-ACTION COMPLETION-KODE GET-ATTRIBUTE. 

FORTRAN: 

CALL IFSGET (STADDR, BUFFER, GETLEM, GETFLD, GET1, GETACT, CCODE,ATR) 

Pascal: 

IFSGET 
(ADDR,B,GET__COUNT,GET_FIELD,GET_START,GET_ACT,CCODE,GET__ATR); 
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990 Assembly Language: 



LI R0,GETARG 

BLWP @IC$GET 



POINTER TO ARGUMENTS LIST 
SUBROUTINE LINKAGE 



GETARG 



DATA 


8*2 


DATA 


OPN1 


DATA 


GET2 


DATA 


GET3 


DATA 


GET4 


DATA 


GET5 


DATA 


GET6 


DATA 


GETCC 


DATA 


GET8 



EIGHT TWO-BYTE POINTERS TO ARGUMENTS 
COMM LINE &TERMINAL ID POINTER 
PROGRAM STATION BUFFER POINTER 
DATA LENGTH POINTER 
FIRST FIELD POINTER 
START POSITION POINTER 
NEXT ACTION POINTER 
COMPLETION CODE POINTER 
ATTRIBUTE POINTER 



OPN1 


DATA 


>0200 




DATA 


>0200 


GET2 


BSS 


2 


GET3 


BSS 


2 


GET4 


BSS 


2 


GET5 


BSS 


2 


GET6 


BSS 


2 


GETCC 


DATA 





GET8 


BSS 


4 



USE THE SAME AS USED FOR THE OPEN 

ROUTINE; AUTOMATICALLY SELECT CRT 

TYPE 

BEGINNING OF STATION BUFFER 

LENGTH OF DATA TO GET 

FIRST FIELD TO GET 

POSITION WITHIN FIELD TO BEGIN GET 

ACTION TO BE TAKEN AFTER GET 

COMPLETION CODE 

2ND WORD ATTRIBUTE ARGUMENT; NOT USED 

5.3.4 Retrieve Attributes Routine — Return Field Attributes 

The Retrieve Attributes routine returns the attributes of up to 40 fields in the station buffer. In 
addition to the list of attributes, this routine returns arguments set to the number of the field fol- 
lowing the last attribute retrieved, the current position of the cursor, a count of attribute 
characters returned, a completion code, and the Write Control Character (WCC) of the current 
screen image. 

The Retrieve Attributes routine optionally returns the value of the write control character (WCC) 
that the host sends with each Write command. The purpose of this routine is to aid you in writing 
new PSC applications or help convert existing PSC applications when the host application 
changes formats. 
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5.3.4.1 Retrieve Attributes Call Statements. The following examples demonstrate the Retrieve 
Attributes call statement in each of the supported programming languages. 

COBOL: 

CALL "IC$ATR" USING < a1>< a2>< a3> < a4> < a5> < a6> < a7> < a8> . 
FORTRAN: 

CALL IFSATR (< a1> ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> ) 
Pascal: 

IFSATR (< a1> ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> ); 

990 Assembly Language: 

LI R0,ATRARG POINTER TO ARGUMENTS LIST 

BLWP @IC$ATR SUBROUTINE LINKAGE 



EIGHT TWO-BYTE POINTERS TO ARGUMENTS 

COMM LINE &TERMINAL ID POINTER 

ATTRIBUTE LIST POINTER 

ATTRIBUTE LIST LENGTH POINTER 

FIRST FIELD POINTER 

CURSOR POSITION POINTER 

RETURN LENGTH POINTER 

COMPLETION CODE POINTER 

WCC POINTER 



DATA 


8*2 


DATA 


<a1> 


DATA 


<a2> 


DATA 


<a3> 


DATA 


<a4> 


DATA 


<a5> 


DATA 


<a6> 


DATA 


<a7> 


DATA 


<a8> 



5.3.4.2 Arguments for the Retrieve Attributes Routine. 

ments for the Retrieve Attributes routine: 



The following list describes the argu- 



<a1> is the control unit and terminal addresses of the PSC program. This argument con- 
sist of two words. The first word contains the control unit address or a specification 
to let ICS choose the control unit address. It also contains a flag that indicates 
whether PSC fills the station buffer with the contents of the local format file. The 
second word contains the terminal address or a specification to let ICS choose the 
terminal address. It also specifies the type (CRT or PRT) of the terminal address. 
Paragraph 5.2.4 describes this argument in detail. 

< a2> is the list in the PSC program to receive the attribute information. A maximum of 120 

words is returned, three words for each attribute. 

< a3> is the number of attribute characters requested. This value can be from 1 through 40. 

< a4> is the number of the first field whose attribute character is retrieved. 
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< a5> is the buffer address of the cursor (from through 1919) that the routine returns if 

the program reserved a video terminal address or the printer line length if the 
program reserved a printer terminal address. 

<a6> is the number of attribute characters actually retrieved (from 1 through 40). The 
routine returns this argument. 

< a7> is the completion code. Zero indicates success. Nonzero completion codes indicate 

an error condition. Refer to Appendix B. 

<a8> Is the WCC of the last write command that the host sent. See Section 5.2.3 for a 
description of the WCC. This argument requires a full word of memory, but the WCC 
occupies only the right (least significant) byte. 

5.3.4.3 Results of the Retrieve Attributes. The Retrieve Attributes routine inspects the station 
buffer and returns a list of attribute characters structured as described in paragraph 5.2.2. Each 
attribute character requires three words. The first word locates the beginning of the field in the 
station buffer, the high-order byte of the second word contains the attribute character, and the 
remainder is not used. 

In addition to the list of attribute characters, the routine returns five values of interest, as follows: 

• The fourth argument, which the program sets to the field number of the first attribute 
wanted, returns the number of the field following the last attribute character retrieved. 
This facilitates a subsequent call to retrieve attributes for the following field. If the last 
attribute character retrieved is the last one in the buffer, this argument returns -1. If the 
attribute characters in the buffer are exhausted before the number requested by the 
third argument can be retrieved, this argument returns -2. 

• The fifth argument returns one of the following: 

— If your program emulates a video station, < a5> returns the current location of the 
cursor. Though the PSC program need not position the cursor to modify a field, 
3270 orders that the host sends manipulate the cursor. This argument allows the 
program to locate the cursor so that it can decide where to perform the next opera- 
tion, if necessary. 

— If your program emulates a printer station, < a5> returns the printer line length. 

• The sixth argument returns the number of attributes actually retrieved. This matches the 
number requested by the third argument unless the routine comes to the end of the 
buffer before retrieving the number requested. 

• The seventh argument returns a completion code. Zero means a successful 
transmission. A nonzero code indicates an error condition. Refer to Appendix B. 

• The eighth argument returns the WCC of the last Write command sent by the host. This 
argument is optional. 
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5.3.4.4 Examples of the Retrieve Attributes Call. The following examples demonstrate the 
Retrieve Attributes call statement in each of the supported programming languages. 

COBOL: 

CALL "IC$ATR"USING STATION-ADDRESS ATR-LIST ATR-HOW-MANY ATR-BEGIN 
ATR-CURSOR COMPLETION-KODE ATR-RETURNED WCC. 

FORTRAN: 

CALL IFSATR (ADDR, ATRB, ATRNUMER, ATRSTRT, ATRCSR, CODE, ATRBKC, WCC) 

Pascal: 

IFSATR (ADDR, ATR_B, ATR_NUMBER, ATR_START, ATR_CURSOR, CCODE, 
ATR_BACK, WCC); 

990 Assembly Language: 

LI R0,ATRARG POINTER TO ARGUMENTS LIST 

BLWP @IC$ATR SUBROUTINE LINKAGE 



ATRARG DATA 


8*2 


DATA 


OPN1 


DATA 


ATR2 


DATA 


ATR3 


DATA 


ATR4 


DATA 


ATR5 


DATA 


ATR6 


DATA 


ATRCC 


DATA 


ATR8 



EIGHT TWO-BYTE POINTERS TO ARGUMENTS 
COMM LINE & TERMINAL ID POINTER 
ATTRIBUTE LIST POINTER 
ATTRIBUTE LIST LENGTH POINTER 
START FIELD POINTER 
CURSOR POSITION POINTER 
RETURN LENGTH POINTER 
COMPLETION CODE POINTER 
WCC POINTER 



OPN1 


DATA 


>0200 




DATA 


>0200 


ATR2 


BSS 


240 


ATR3 


BSS 


2 


ATR4 


BSS 


2 


ATR5 


BSS 


2 


ATR6 


BSS 


2 


ATRCC 


BSS 


2 


ATWCC 


BSS 


2 



USE THE SAME AS USED BY THE OPEN 

ROUTINE; AUTOMATICALLY SELECT CRT 

TYPE 

ATTRIBUTE LIST; 

ATTRIBUTE LIST LENGTH 

START FIELD 

CURSOR POSITION 

RETURN LENGTH 

COMPLETION CODE 

WCC 
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5.3.5 Transmit Routine — Send Station Buffer to Host 

The Transmit routine can transmit all the modified fields in the station buffer to the host applica- 
tion. This routine generates an attention ID (AID) code for the transmission and returns a comple- 
tion code indicating its success. The local print option is included for debugging purposes and 
transmits nothing to the host. 

5.3.5.1 Transmit Call Statements. The following examples demonstrate the Transmit routine 
call statement for each supported programming language. 

COBOL: 

CALL "IC$XMT" USING <a1> <a2> <a3>. 
FORTRAN: 

CALL IFSXMT (< a1 > ,< a2> ,< a3> ) 
Pascal: 

I FSXMT (< a1 > ,< a2> ,< a3> ); 

990 Assembly Language: 

LI R0,XMTARG POINTER TO ARGUMENTS LIST 

BLWP @IC$XMT SUBROUTINE LINKAGE 



XMTARG 



DATA 3*2 

DATA <a1> 

DATA < a2> 

DATA < a3> 



THREE TWO-BYTE POINTERS TO ARGUMENTS 
COMM LINE & TERMINAL ID POINTER 
AID CODE POINTER 
COMPLETION CODE POINTER 



5.3.5.2 Arguments for the Transmit Routine. 

Transmit routine: 



The following list describes the arguments for the 



< a1> is the control unit and terminal addresses of the PSC program. This argument con- 

sist of two words. The first word contains the control unit address or a specification 
to let ICS choose the control unit address. It also contains a flag that indicates 
wether PSC fills the statin buffer with the contents of the local format file. The sec- 
ond word contains the terminal address or a specification to let ICS choose the ter- 
minal address. It also specifies the type (CRT or PRT) of the terminal address. 
Paragraph 5.2.4 describes this argument in detail. 

<a2> is the AID code for the transmission. This argument conveys an AID to the host 
along with the modified fields in the station buffer. Table 5-1 lists the AID codes that 
correspond to the program attention keys on the display station keyboard. 

< a3> is a completion code. The routine returns a zero completion code when the opera- 

tion succeeds. A nonzero code indicates an error condition. Refer to Appendix B. 
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Table 5-1. Attention ID (AID) Codes 



Program 




Program 




Attention Key 


Attention ID Code 


Attention key 


Attention ID Code 


Enter 





Clear 


16 


PF1 


1 


Reset 


17 


PF2 


2 


PF13* 


18 


PF3 


3 


PF14* 


19 


PF4 


4 


PF15* 


20 


PF5 


5 


PF16* 


21 


PF6 


6 


PF17* 


22 


PF7 


7 


PF18* 


23 


PF8 


8 


PF19* 


24 


PF9 


9 


PF20* 


25 


PF10 


10 


PF21* 


26 


PF11 


11 


PF22* 


27 


PF12 


12 


PF23* 


28 


PA1 


13 


PF24* 


29 


PA2 


14 


SYSREQ 


Not supported 


PA3 


15 


Print 


31 



Note: 

* Program Function (PF) keys 13 through 24 are not supported by the IBM 3271 Model 2 Control 
Unit and the IBM 3277 Model 2 Display Station. They are supported by the IBM 3274 Model 1 
Control Unit, the IBM 3276 Model 2 Control Unit, and the IBM 3278 Model 2 Display Station. 



5.3.5.3 Results of the Transmit. The Transmit routine typically sends a message across the 
ICS line to a remote host application. The message begins with the AID code specified in the call. 
Then, the message lists the contents of every modified field in the station buffer. Fields become 
modified when filled by the Fill routine. 

The following list describes four of the AID codes that warrant special mention: 
Code Description 

Enter The enter code signifies that the station has a message for the host application. 

Once the program has a buffer ready to transmit, it calls the Transmit routine 
with this AID code. Then, all of the modified data is transmitted to the host. 

Clear The clear code replaces all data(including attribute characters) in the station 

buffer with nulls. Only the clear code is transmitted to the host. 

Reset If the keyboard is locked, reset unlocks it. ICS transmits no data. 

Print The print code is an internal code provided to help you debug a program. No 

transmission is made to the host. Instead, the Print code writes the contents of 
the station buffer to the default print pathname (the value last assigned to the 
terminal address in use). Once your PSC program begins execution, you cannot 
change the current value of the PRINT key pathname. 
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The Transmit routine returns a completion code in its third argument. Zero means a successful 
transmission. A nonzero code indicates an error condition. Refer to Appendix B. 

5.3.5.4 Examples of the Transmit Call. The following examples demonstrate the Transmit 
routine call statement in each supported programming language. 

COBOL- 
CALL "IC$XMT" USING STATION-ADDRESS AID-KODE COMPLETION-KODE. 

FORTRAN: 

CALL IFCXMT(STADDR, XMTAID, CCODE) 

Pascal: 

IFSXMT (ADDR, AID_CODE, CCODE); 

990 Assembly Language: 

LI R0,XMTARG POINTER TO ARGUMENTS LIST 

BLWP @IC$XMT SUBROUTINE LINKAGE 



XMTARG 



DATA 3*2 

DATA OPN1 

DATA XMT2 

DATA XMTCC 



THREE TWO-BYTE POINTERS TO ARGUMENTS 
COMM LINE & TERMINAL ID POINTER 
AID CODE POINTER 
COMPLETION CODE POINTER 



OPN1 


DATA 


>0200 


USE THE SAME AS USED BY THE OPEN 




DATA 


>0200 


ROUTINE; AUTOMATICALLY SELECT 
CRT TYPE 


XMT2 


BSS 


2 


AID CODE 


XMTCC 


DATA 





COMPLETION CODE 



5.3.6 Time-out Routine — Wait for Host to Respond 

The Time-out routine temporarily suspends execution of the PSC program for a specified period. 
This routine returns a completion code that indicates the success of the operation. 
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5.3.6.1 Time-out Call Statements. The following examples demonstrate the Time-out routine 
call statement for each of the supported programming languages. 

COBOL: 

CALL "IC$TMO" USING < a1>< a2>< a3> . 
FORTRAN: 

CALL IFSTMO (< a1> ,< a2> ,< a3>) 
Pascal: 

IFSTMO (< a1> ,< a2> ,< a3> ); 

990 Assembly Language: 

LI R0JMOARG POINTER TO ARGUMENTS LIST 

BLWP @IC$TMO SUBROUTINE LINKAGE 



TMOARG DATA 3*2 

DATA <a1> 

DATA < a2> 

DATA < a3> 



THREE TWO-BYTE POINTERS TO ARGUMENTS 
COMM LINE & TERMINAL ID POINTER 
TIME INTERVAL POINTER 
COMPLETION CODE POINTER 



5.3.6.2 Arguments for the Time-out Routine. 

Time-out routine: 



The following list describes the arguments for the 



< a1> is the control unit and terminal addresses of the PSC program. This argument con- 
sist of two words. The first word contains the control unit address or a specification 
to let ICS choose the control unit address. It also contains a flag that indicates 
whether PSC fills the station buffer with the contents of the local format file. The 
second word contains the terminal address or a specification to let ICS choose the 
terminal address. It also specifies the type (CRT or PRT) of the terminal address. 
Paragraph 5.2.4 describes this argument in detail. 

<a2> is the number of time-out intervals. This argument specifies the number of 50- 
millisecond intervals to elapse before the the program resumes operation. 

<a3> is a completion code. The routine returns a zero completion code when the opera- 
tion succeeds. Nonzero codes indicate error conditions. Refer to Appendix B. 

5.3.6.3 Results of the Time-out. The Time-out routine causes the PSC program task to wait for 
the specified number of 50-millisecond intervals to elapse or until the PSC Emulator receives data 
from the host. The program resumes execution with the statement following the call. To give the 
host sufficient time to respond and write new data into the station buffer, you can call this routine 
after a Transmit call. If you are unsure how long the time-out should be, specify a value larger than 
you need and rely on the PSC Emulator to terminate the time-out when it receives data from the 
host. 
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The routine returns a completion code in its third argument. Zero means success. A nonzero com- 
pletion code indicates an error condition. 

5.3.6.4 Examples of the Time-out Call. The following examples demonstrate the Time-out 
routine call statement for each supported programming language. 

COBOL: 

CALL "IC$TMO" USING STATION-ADDRESS TMO-HOW-LONG COMPLETION-KODE. 
FORTRAN: 

CALL IFSTMO (STADDR, TMOCNT, CCODE) 
Pascal: 

IFSTMO (ADDR, TIME_OUT_INTERVALS, CCODE); 

990 Assembly Language: 

LI R0JMOARG POINTER TO ARGUMENTS LIST 

BLWP @IC$TMO SUBROUTINE LINKAGE 



TMOARG 



DATA 3*2 

DATA OPN1 

DATA TM02 

DATA TMOCC 



THREE 2-BYTE POINTERS TO ARGUMENTS 
COMM LINE &TERMINAL ID POINTER 
TIME INTERVAL POINTER 
COMPLETION CODE POINTER 



OPN1 DATA >200 

DATA > 200 

DATA 2 

BSS 2 



USE THE SAME AS USED FOR THE OPEN 
ROUTINE; AUTOMATICALLY SELECT 
CRT TYPE 

TIME INTERVAL; WAIT 100 MILLISECONDS 
COMPLETION CODE 



5.3.7 Close Routine — Close Station 

The Close routine releases a station from PSC program control. The call indicates what status to 
report to ICS. One argument specifies to the PSC Emulator whether the PSC Emulator is to termi- 
nate itself or remain active. If a user-written PSC program closes the PSC Emulator using the Do 
not terminate option and then terminates itself, the PSC Emulator automatically rebids your PSC 
program when it receives data from the host that is directed to the terminal address reserved for 
your PSC program. The PSC Emulator can successfully rebid your PSC program only if it resides in 
the .S$PROGA program file. If you use the do not terminate option but do not terminate your 
program, the PSC Emulator does not attempt to bid a new copy of your program. 
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5.3.7.1 Close Call Statements. The following examples demonstrate the Close routine call 
statement for each supported programming language. 

COBOL: 

CALL "IC$CLS" USING < a1>< a2>< a3> . 
FORTRAN: 

CALL IFSCLS (< a1> ,< a2> ,< a3> ) 
Pascal: 

IFSCLS (< a1 > ,< a2> ,< a3> ); 

990 Assembly Language: 

LI RO.CLSARG POINTER TO ARGUMENTS LIST 

BLWP @IC$CLS SUBROUTINE LINKAGE 



CLSARG DATA 3*2 

DATA <a1> 

DATA < a2> 

DATA < a3> 

5.3.7.2 Arguments for the Close Routine. 

Close routine: 



THREE TWO-BYTE POINTERS TO ARGUMENTS 
COMM LINE & TERMINAL ID POINTER 
TERMINATE FLAG POINTER 
COMPLETION CODE POINTER 

The following list describes the arguments for the 



< a1> is the control unit and terminal addresses of the PSC program. This argument con- 

sist of two words. The first word contains the control unit address or a specification 
to let ICS choose the control unit address. It also contains a flag that indicates 
whether PSC fills the station buffer with the contents of the local format file. The 
second word contains the terminal address or a specificaton to let ICS choose the 
terminal address. It also specifies the type (CRT or PRT) of the terminal address. 
Paragraph 5.2.4 describes this argument in detail. 

< a2> indicates whether the station remains active after the call, as follows: 

0= Suspend the station until data arrives from the host. 

2= Terminate operations at the station. 

<a3> is a completion code. The routine returns a zero completion code when the opera- 
tion succeeds. A nonzero code indicates error. Refer to Appendix B. 
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5.3.7.3 Results of the Close. The Close routine releases the station from the control of the PSC 
program. If the second argument equals zero, the PSC Emulator waits until a message arrives 
from the host or the PSC application issues an Open do not activate call. If data arrives from the 
host, the PSC program is rebid. If the second argument equals two, the Close routine terminates 
the PSC Emulator and releases the ICS terminal address. 

The third argument returns a completion code to the program after the routine closes the station. 
Zero means the operation succeeded. A nonzero code indicates an error condition listed in Appen- 
dix B. 

NOTE 

Anytime the user program terminates abnormally, a Close specify- 
ing Terminate (a value of two for < a2>) must be issued to the PSC 
Emulator. The Close call should always be included as part of the 
abnormal termination procedure of a PSC program. 

5.3.7.4 Examples of the Close Call. The following examples demonstrate the Close routine call 
statement for each supported programming language. 

COBOL: 

CALL "IC$CLS" USING STATION-ADDRESS DUMMY COMPLETION-KODE. 
FORTRAN: 

CALL IFSCLS(STADDR, CLSDUM, CCODE) 
Pascal: 

IFSCLS(ADDR, DUMMY, CCODE); 

990 Assembly Language: 

LI R0,CLSARG POINTER TO ARGUMENTS LIST 

BLWP @IC$CLS SUBROUTINE LINKAGE 



CLSARG 



DATA 3*2 

DATA OPN1 

DATA CLS2 

DATA CLSCC 



THREE TWO-BYTE POINTERS TO ARGUMENTS 
COMM LINE &TERMINAL ID POINTER 
TERMINATE FLAG POINTER 
COMPLETION CODE POINTER 



OPN1 


DATA 


>0200 




DATA 


>0200 


CLS2 


DATA 


2 


CLSCC 


DATA 





2250954-9701 







USE THE SAME AS USED FOR THE OPEN 
ROUTINE; AUTOMATICALLY SELECT 
CRT TYPE 
TERMINATE 
COMPLETION CODE 
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5.4 WRITING A PSC PROGRAM 

Writing a PSC program requires the same steps as developing any other application program 
under DX10 plus one additional step, patching. You compile or assemble the program in the usual 
way, link it with the PSC routines it calls, patch those routines, and execute it with an SCI com- 
mand. The Execute Programmed Station Control (XPSC) command activates a user-written PSC 
program. 

You must know the generated configuration of the host so that your PSC program uses the correct 
control unit and terminal addresses. For some host configurations, your PSC program must log on 
to the desired application. Writing a PSC program also requires that you be familiar with the fol- 
lowing aspects of the host application: 

• Screen format 

• Valid responses for each field 

• Use of special function keys (PF1 - PF24, PA1 - PA3) 

ICS contains a useful program development aid that allows you to execute PSC call statements 
individually, providing parameters in a menu-driven fashion. The Release Information, DX10 3270 
ICS document contains a description of how to install and execute this program. 

These paragraphs contain no discussion of the process of compiling or assembling the program 
since the individual language manuals provide all the needed information. 

To create a source program, you insert calls to the following PSC routines in place of routines that 
perform I/O to host: 

Routine Description 

Fill Sends output to the station buffer 

Get Retrieves information from the station buffer 

Transmit Sends information to the host 

PSC returns a completion code for each call to a PSC routine. Zero indicates a successful opera- 
tion. Nonzero codes indicate error conditions. Refer to Appendix B. 

If your PSC program issues a Close call specifying Do not terminate, the PSC Emulator rebids your 
program when data arrives from the host. When the PSC Emulator rebids your program, it passes 
two parameters that your program can access using the retrieve task parameters call appropriate 
to the language that you are using. Each parameter is one word (16 bits). The first parameter con- 
tains the decimal control unit address that the PSC Emulator has reserved for your program in the 
first byte (bits through 7). The second byte (bits 8 through 15) of the first parameter contains the 
decimal terminal address that the PSC Emulator has reserved for your program. The second 
parameter is always zero. Your program must use these passed addresses for the first argument 
in the Open Do not activate in order for your program to regain access to the PSC Emulator. 
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A PSC program that infrequently processes host data, such as a printer, can use the Close call 
specifying Do not terminate and subsequently, the Open call specifying Do not activate. When 
your PSC program issues the Close call specifying Do not terminate and terminates itself, idle 
memory and system resources belonging to the PSC program are returned to the operating 
system and made available for other uses. 

5.4.1 COBOL Call Statements 

The following lists suggest data structures that your COBOL program can use for each of the 
arguments of each PSC routine. It also shows the COBOL call statement for each PSC routine. 

Open Call: 

CALL "IC$OPN" USING < a1>< a2> < a3>< a4> . 



rgument 


Data Type 


Picture 


Values 


Meaning of Values 


<a1> 


GROUP 






First argument 2 words 




COMP-1 


9(2) 


0-1536 


Control unit address 




COMP-1 


9(2) 


0-768 


Terminal address 


<a2> 


COMP-1 


9(2) 


0or2 


Activate interface 


<a3> 


COMP-1 


9(2) 





Dummy argument 


<a4> 


COMP-1 


9(4) 


0-255 


Completion code 



Fill Call: 

CALL "IC$FIL" USING < a1> < a2> < a3> < a4> < a5> < a6> < a7> < a8> . 

Meaning of Values 

First argument 2 words 
Control unit address 
Terminal address 
Data to fill station 
buffer 

Number of characters 
infill 

Number of field to fill 
Position in field to 
start fill 

Next action: none, 
transmit, clear 
Completion code 
Attributes of field 
Real attribute byte 
Slack bytes 



Argument 


Data Type 


Picture 


Values 


<a1> 


GROUP 








COMP-1 


9(2) 


0-1536 




COMP-1 


9(2) 


0-768 


<a2> 


DISPLAY 


X(<n>) 


< n> chars 


<a3> 


COMP-1 


9(4) 


1-240 


<a4> 


COMP-1 


9(4) 


1-1919 


<a5> 


COMP-1 


9(4) 


1-1920 


<a6> 


COMP-1 


9(4) 


0,1, or 3 


<a7> 


COMP-1 


9(4) 


0-255 


<a8> 


GROUP 








COMP-1 


9(1) 


64 - 255 




COMP-1 


9(3) 
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Get Call: 

CALL "IC$GET" USING < a1> < a2> < a3> < a4> < a5> < a6> < a7> < a8> . 
Argument Data Type Picture Values Meaning of Values 



<a1> 


GROUP 






First argument 2 words 




COMP-1 


9(2) 


0-1536 


Control unit address 




COMP-1 


9(2) 


0-768 


Terminal address 


<a2> 


DISPLAY 


X(<n>) 


<n> chars 


Data obtained from 
station buffer 


<a3> 


COMP-1 


9(4) 


1-240 


Number of characters to 
get 


<a4> 


COMP-1 


9(4) 


1-1920 


Number of field to get 


<a5> 


COMP-1 


9(4) 


1-1920 


Position in field to 
start 


<a6> 


COMP-1 


9(4) 


0,1, or 3 


Next action: none, 
transmit, clear 


<a7> 


COMP-1 


9(4) 


0-255 


Completion code 


<a8> 


GROUP 






Attributes of field 




COMP-1 


9(1) 


64 - 255 


Real Attribute byte 




COMP-1 


9(3) 




Slack bytes 



Attribute Call: 

CALL "IC$ATR" USING < a1>< a2> 
Argument Data Type Picture 



< a3> < a4> < a5> < a6> < a7> < a8> . 

Values Meaning of Values 



<a1> 










First Argument 2 words 




COMP-1 


9(2) 


0- 


-1536 


Control unit address 




COMP-1 


9(2) 


0- 


-768 


Terminal address 


<a2> 


OCCURS 40 
TIMES 








Attribute information 




COMP-1 


9(4) 


0- 


-1919 


Position 




DISPLAY 


X 


64 


-255 


Attribute 




DISPLAY 


X(3) 






Not used 


<a3> 


COMP-1 


9(2) 


1- 


-40 


Max number of attributes 
returned 


<a4> 


COMP-1 


9(4) 


1- 


-1920 


Number of first attribute 
to get 


<a5> 


COMP-1 


9(4) 


0- 


-1919 


Current cursor location 


<a6> 


COMP-1 


9(2) 


1- 


-40 


Number of attributes 
returned 


<a7> 


COMP-1 


9(4) 


0- 


-255 


Completion code 


<a8> 


COMP-1 


9(4) 


0- 


-255 


WCC 
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Time-out Call: 

CALL "IC$TMO" USING < a1> , < a2> , < a3> 



Argument 
<a1> 



Data Type 

GROUP 
COMP-1 
COMP-1 

COMP-1 



Picture 



9(2) 
9(2) 
9(4) 



Values 



0-1536 
0-768 
1 - 32767 



<a2> 

<a3> COMP-1 9(4) 0-255 

Transmit Call: 

CALL "IC$XMT" USING < a1> , < a2> , < a3> . 



Close Call: 

CALL "IC$CLS" USING < a1> , < a2> , < a3> . 
Argument Data Type Picture Values 



Meaning of Values 

First argument 2 words 
Control unit address 
Terminal address 

Time-out in50-msec 

intervals 

Completion code 



Argument 


Data Type 


Picture 


Values 


Meaning of Values 


<a1> 


GROUP 






First argument 2 words 




COMP-1 


9(2) 


0-1536 


Control unit address 




COMP-1 


9(2) 


0-768 


Terminal address 


<a2> 


COMP-1 


9(2) 


0-31 


AID Code (see Tabel 5-1) 


<a3> 


COMP-1 


9(4) 


0-255 


Completion code 



Meaning of Values 



<a1> 


GROUP 






First argument 2 words 




COMP-1 


9(2) 


0-1536 


Control unit address 




COMP-1 


9(2) 


0-768 


Terminal address 


<a2> 


COMP-1 


9 


0or2 


Reactivate: yes or no 


<a3> 


COMP-1 


9(4) 


0-255 


Completion code 
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5.4.2 FORTRAN Call Statements 

The following list suggests data structures that your FORTRAN program can use for each argu- 
ment of each PSC routine. The list also shows the FORTRAN call statement for each PSC routine. 

Open Call: 

CALL IFSOPN (< a1> , < a2> , < a3> , < a4> ) 



Argument 


Data Type 


Size 


Values 


Meaning of Values 


<a1> 


lnteger(2) 


Two words 


0-1536 
0-768 


Communications line and 
terminal address 


<a2> 


Integer 


Word 


0or2 


Activate interface 


<a3> 


Integer 


Word 





Dummy argument 


<a4> 


Integer 


Word 


0-255 


Completion code 



Fill Call: 

CALL IFSFIL (< a1> ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> 



Argument Data Type 



Size 



Values 



Meaning of Values 



<a1> 


lnteger(2) 


Two words 


0-1536 




<a1> 


lnteger(2) 


Two words 


0-1536 
0-768 


Communications line and 
terminal address 


<a2> 


lnteger(120) 


N/2 words 


Any 
ASCII 


Data to fill 
station buffer 


<a3> 


Integer 


Word 


1-240 


Number of characters 
infill 


<a4> 


Integer 


Word 


1-1920 


Number of field 
to fill 


<a5> 


Integer 


Word 


1-1920 


Position in field 
to start fill 


<a6> 


Integer 


Word 


0,1, or3 


Next action: none, 
transmit, clear 


<a7> 


Integer 


Word 


0-255 


Completion code 


<a8> 


lnteger(2) 


Two words 


64-255 


Attribute byte 
+ 3 slack bytes 
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Get Call: 

CALL I FSGET (< a1 > ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> ) 



Argument 


Data Type 


Size 


Values 


Meaning of Values 


<a1> 


lnteger(2) 


Two words 


0-1536 
0-768 


Communications line and 
terminal address 


<a2> 


lnteger(120) 


120 words 


Any 
ASCII 


Data obtained from 
station buffer 


<a3> 


Integer 


Word 


1-240 


Number of characters 
to get 


<a4> 


Integer 


Word 


1-1919 


Number of field to get 


<a5> 


Integer 


Word 


1-1920 


Position in field 
to start 


<a6> 


Integer 


Word 


0,1, or 3 


Next action: none, 
transmit, clear 


<a7> 


Integer 


Word 


0-255 


Completion code 


<a8> 


lnteger(2) 


Two words 


64-255 


Attribute byte 
+ 3 slack bytes 



Attribute Call: 

CALL I FSATR (< a1 > ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> 



Argument 


Data Type 


Size 


Values 


Meaning of Values 


<a1> 


lnteger(2) 


Two words 


0-1536 
0-768 


Communications line 
terminal address 


<a2> 


lnteger(3,40) 


240 bytes 


64 - 255 


Attributes of up 
to 40 fields 


<a3> 


Integer 


Word 


0-40 


Number of attributes 


<a4> 


Integer 


Word 


1-1920 


Number of first field 


<a5> 


Integer 


Word 


0-1919 


Current location of 
cursor 


<a6> 


Integer 


Word 


0-40 


Number of attributes 
returned 


<a7> 


Integer 


Word 


0-255 


Completion code 


<a8> 


Integer 


Word 


0-255 


WCC 



Time-out Call: 

CALL IFSTMO (< a1> , < a2> , < a3> ) 
Argument Data Type Size 

<a1> lnteger(2) Two words 

<a2> Integer Word 

<a3> Integer Word 

2250954-9701 



Values Meaning of Values 

0-1536 Communications line and 

0-768 terminal address 

1 - 32767 Time-out in 50-msec 

intervals 
0-255 Completion code 
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Transmit Call: 

CALL I FSXMT (< a1 > , < a2> , < a3> ) 
Argument Data Type Size 

<a1> lnteger(2) Two words 



<a2> 
<a3> 

Close Call: 



Integer 
Integer 



Word 
Word 



Values 

0-1536 
0-768 
0-31 
0-255 



Meaning of Values 

Communications line and 
terminal address 
AID code (see Table 5-1) 
Completion code 



CALL IFSCLS (< a1> , < a2> , < a3>) 



Argument Data Type 



Size 



Values 



<a1> 


lnteger(2) 


Two words 


0-1536 
0-768 


<a2> 


Integer 


Word 


0or2 


<a3> 


Integer 


Word 


0-255 



Meaning of Values 

Communications line and 
terminal address 
Reactivate: yes, no 
Completion code 

5.4.3 Pascal Call Statements 

Pascal programs normally allocate their stack and heap sizes dynamically. If you design your 
Pascal PSC program to be rebid by the PSC Emulator, you must not use this feature. The PSC 
Emulator cannot pass the necessary parameters to dynamically allocate the stack and heap. If 
you do not design your Pascal PSC program to be rebid by the PSC Emulator, you can use the 
dynamic allocation of stack and heap sizes. You must however, activate your program by using 
the Execute Pascal Task (XPT) command. 

The PSC Emulator can successfully rebid your Pascal PSC program only if your program allocates 
the stack and heap size statically and you activate it by using XPSC. The DX10 Tl Pascal Program- 
mer's Manual describes how to statically allocate the stack and heap. 

When you declare the PSC routines that your program calls, you must define them as external 
FORTRAN procedures. 

The following lists suggest data structures that your Pascal program can use for each of the argu- 
ments of each PSC routine. It also shows the Pascal call statement for each PSC routine. 



Open Call: 

IFSOPN (< a1 > , < a2> , < a3> , < a4> ); 

Argument Data Type Size 

<a1> Array[0..1] Two words 

of integer 

<a2> Integer Word 

<a3> Integer Word 

<a4> Integer Word 



Values Meaning of Values 

0-1536 Communications line and 

0-768 terminal address 

or 2 Activate interface 

Dummy argument 

- 255 Completion code 
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Fill Call: 

IFSFIL (< a1 > ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> 



rgument 


Data Type 


Size 


Values 


Meaning of Values 


<a1> 


Array[0..1] 


Two words 


0-1536 


Communications line and 




of integer 




0-768 


terminal address 


<a2> 


Packed 


N/2 words 


Any 


Data to fill 




Array[1..n] 




ASCII 


station buffer 




of characters 








<a3> 


Integer 


Word 


1-240 


Number of characters in 

fill 

Number of field to fill 


<a4> 


Integer 


Word 


1-1920 


<a5> 


Integer 


Word 


1-1920 


Position in field to 
start fill 


<a6> 


Integer 


Word 


0,1, or 3 


Next action: none, 
transmit, clear 


<a7> 


Integer 


Word 


0-255 


Completion code 


<a8> 


Packed 
Array[1..4] 
of byte 


Two words 


64 - 255 


Attribute byte + 3 
slack bytes 



Get Call: 

IFSGET (< a1>,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> ); 



Argument 


Data Type 


Size 


Values 


Meaning of Values 


<a1> 


Array [0..1] 


Two words 


0-1536 


Communications line and 




of integer 




0-768 


terminal address 


<a2> 


Packed 


N/2 words 


Any 


Data obtained from 




array[0..N] 




ASCII 


station buffer 




of character 








<a3> 


Integer 


Word 


1-240 


Number of characters to get 


<a4> 


Integer 


Word 


1-1920 


Number of field to get 


<a5> 


Integer 


Word 


1-1920 


Number of field to get 


<a6> 


Integer 


Word 


0,1,or3 


Next action: none, 
transmit, clear 


<a7> 


Integer 


Word 


0-255 


Completion code 


<a8> 


Packed 
Array[1..4] 
of byte 


Two words 


64-255 


Attribute byte +3 
slack bytes 
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Attribute Call: 

I FSATR (< a1 > ,< a2> ,< a3> ,< a4> ,< a5> ,< a6> ,< a7> ,< a8> ); 



gument 


Data Type 


Size 


Values 


Meaning of Values 


<a1> 


Array[0..1] 


Two words 


0-1536 


Communications line and 




of integer 




0-768 


terminal address 


<a2> 


Array[1..n] 


3X<n> 


64 - 255 






of records 


Words 




Attributes of up to 40 
fields 


<a3> 


Integer 


Word 


0-40 


Number of attributes 


<a4> 


Integer 


Word 


1-1920 


Number of first field 


<a5> 


Integer 


Word 


0-1919 


Current cursor location 


<a6> 


Integer 


Word 


0-40 


Number of attributes 
returned 


<a7> 


Integer 


Word 


0-255 


Completion code 


<a8> 


Integer 


Word 


0-255 


WCC 



Time-out Call: 

IFSTMO (< a1> , < a2> , < a3> ); 
Argument 
<a1> 
<a2> 
<a3> 
Transmit Call: 

IFSXMT (< a1> , < a2> , < a3> ); 
Argument Data Type Size 



Data Type 


Size 


Values 


Meaning of Values 


Array[0..1] 


Two words 


0-1536 


Communications line and 


of integer 




0-768 


terminal address s 


Integer 


Word 


1 - 32767 


Time-out in 50-msec 
intervals 


Integer 


Word 


0-255 


Completion code 



Values 



Meaning of Values 



<a1> 


Array[0..1] 


Two words 


0- 


-1536 


Communications line and 




of integer 




0- 


-768 


terminal address 


<a2> 


Integer 




0- 


-31 


AID code - (see Table 5-1) 


<a3> 


Integer 




0- 


-255 


Completion code 
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Close Call: 

I FSCLS (< a1 > , < a2> , < a3> ); 

Argument Data Type Size 

<a1> Array[0..1] Two words 

of integer 

<a2> Integer Word 

<a3> Integer Word 



Values Meaning of Values 

0-1536 Communications line and 

0-768 terminal address 

or 2 Reactivate: yes, no 

0-255 Completion code 



5.4.4 990 Assembly Language Call Statements 

The following list suggests data structures that your 990 assembly language program can use for 
each of the arguments of each PSC routine. The first shows the 990 assembly language call state- 
ment for each PSC routine. 

Open Call: 





LI 


R0,OPNARG 








BLWP 


@IC$OPN 






OPNARG 


DATA 
DATA 
DATA 
DATA 
DATA 


4*2 
<a1> 
<a2> 
<a3> 

<a4> 








Argument 


Value Type 




Size 


Values 


Meaning of Values 


<a1> 


Dec integer 




Two words 


0-1536 


Control unit and 
terminal address 


<a2> 


Dec integer 




Word 


0or2 


Activate interface: 
yes or no 


<a3> 


Dec integer 




Word 





Dummy argument 


<a4> 


Dec integer 




Word 


0-255 


Completion code 


Fill Call: 














LI 


R0.FILARG 








BLWP 


@IC$FIL 






FILARG 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


8*2 

<a1> 

<a2> 

<a3> 

<a4> 

<a5> 

<a6> 

<a7> 

<a8> 









2250954-9701 



5-43 



Programmed Station Control 



Argument 


Value Type 


Size 


Values 


Meaning of Values 


<a1> 


Dec integer 


Two words 


0-1536 


Control unit and terminal 
address 


<a2> 


Character 


N words 


N chars 


Data to fill station 
buffer 


<a3> 


Dec integer 


Word 


1-240 


Number of characters in 
fill 


<a4> 


Dec integer 


Word 


1-1919 


Number of first field 
to fill 


<a5> 


Dec integer 


Word 


1-1920 


Position in field to 
start fill 


<a6> 


Dec integer 


Word 


0,1,or3 


Next action: none, 
transmit, clear 


<a7> 


Dec integer 


Word 


0-255 


Completion code 


<a8> 


Dec integer 


Two words 


64-255 


Attribute in high-order 
byte 


Get Call: 












LI RO,GETARG 








BLWP @IC$GET 






GETARG 


DATA 8*2 
DATA <a1> 
DATA < a2> 
DATA < a3> 
DATA < a4> 
DATA < a5> 
DATA < a6> 
DATA < a7> 
DATA < a8> 








Argument 


Value Type 


Size 


Values 


Meaning of Values 


<a1> 


Dec integer 


Two words 


0-1536 


Control unit and terminal 
address 


<a2> 


Character 


N words 


N chars 


Data obtained from station 
buffer 


<a3> 


Dec integer 


Word 


1-240 


Number of characters to get 


<a4> 


Dec integer 


Word 


1 - 1920 


Number of field to get 


<a5> 


Dec integer 


Word 


1-1920 


Position in field to 
start 


<a6> 


Dec integer 


Word 


0,1, or3 


Next action: none, 
transmit, clear 


<a7> 


Dec integer 


Word 


0-255 


Completion code 


<a8> 


Dec integer 


Two words 


64-255 


Attribute in high-order 
byte 
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Attribute Call: 




LI 


RO.ATRARG 


BLWP 


$IC$ATR 


ATRARG DATA 


8*2 


DATA 


<a1> 


DATA 


<a2> 


DATA 


<a3> 


DATA 


<a4> 


DATA 


<a5> 


DATA 


<a6> 


DATA 


<a7> 


DATA 


<a8> 



Argument 


Value Type 




Size 


Values 


Meaning of Values 


<a1> 


Dec integer 




Two words 


0-1536 


Control unit and terminal 
address 


<a2> 


Dec integer 




Three words 


Perattr 


Up to 40 attributes 


<a3> 


Dec integer 




Word 


0-40 


Max attributes to get 


<a4> 


Dec integer 




Word 


1-1920 


Number of first field 


<a5> 


Dec integer 




Word 


0-1919 


Current cursor location 


<a6> 


Dec integer 




Word 


0-40 


Number of attributes 


<a7> 


Dec integer 




Word 


0-255 


Completion code 


<a8> 


Dec integer 




Word 


0-255 


WCC 


Time-out Call: 












LI 


ROJMOARG 








BLWP 


@IC$TMO 






TMOARG 


DATA 
DATA 
DATA 
DATA 


3*2 
<a1> 
<a2> 
<a3> 








Argument 


Value Type 




Size 


Values 


Meaning of Values 


<a1> 


Dec integer 




Two words 


0-1536 


Control unit and terminal 
address 


<a2> 


Dec integer 




Word 


1 - 32767 


Time-out in 50-msec 
intervals 


<a3> 


Dec integer 




Word 


0-255 


Completion code 
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Transmit Call: 










XMTARG 


LI 

BLWP 

DATA 

DATA 

DATA 

DATA 


R0,XMTARG 

@IC$XMT 

3*2 

<a1> 

<a2> 

<a3> 






Argument 


Value Type 




Size 


Values 


Meaning of Values 


<a1> 

<a2> 
<a3> 


Dec integer 

Dec integer 
Dec integer 




Two words 

Word 
Word 


0-600 

0-31 
0-255 


Control unit and terminal 

address 

AID code (see Table 5-1) 

Completion code 


Close Call: 












CLSARG 


LI 

BLWP 

DATA 

DATA 

DATA 

DATA 


R0,CLSARG 

@IC$CLS 

3*2 

<a1> 

<a2> 

<a3> 







Argument Value Type 



Meaning of Values 



<a1> 


Dec integer 


Two words 


0-1536 


Control unit and terminal 
address 


<a2> 


Dec integer 


Word 


0or2 


Reactivate: yes or no 


<a3> 


Dec integer 


Word 


0-255 


Completion code 



5.4.5 Calling Sequence Examples 

Figures 5-7 through 5-10 illustrate a proper calling sequence for each PSC routine in each sup- 
ported programming language. 



5.5 LINKING PSC PROGRAMS 

User-written programs must link in the PSC routines before execution. The two methods to include 
the necessary modules in a link stream are as follows: 

• Library — Link editor automatically includes modules required by the user written 
program 

• Module — Each individual object module is explicitly referenced by using an INCLUDE 
command 
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IDENTIFICATION DIVISION. 
PROGRAM-ID. PSC. 



* THIS EXAMPLE ILLUSTRATES PSC CALLS AND THE ASSOCIATED 

* DATA STRUCTURES. HOWEVER, THE SEQUENCE OF THE HALLS DOES NOT 

* REFLECT HOW A TYPICAL PSC PROGRAM SHOULD BE STRUCTURED." 



ENVIRONMENT DIVISION. 
CONFIGURATION SECTION. 
SOURCE-COMPUTER . T I -990 . 
OBJECT-COMPUTER. TI-990. 

DATA DIVISION. 

WORK I NG-STORAGE SECT I ON . 

01 STATION-ADDRESS. 

03 ICS-LINE PIC 9(2) 
03 TERM-ADDRESS PIC 9(2) 



01 OPN-ARGUMENTS. 
03 ACTIVATE 
03 DUMMY 

01 F I L- ARGUMENTS. 
03 FILL-BUFFER 
03 FILL-HOW-MANY . 
03 FILL-FIELD 
03 FILL-BEGIN 
03 FILL-ACTION 
03 FILL-ATTRIBUTE. 

05 ATTR-BYTE 

05 -FILLER 

01 GET-ARGUMENTS. 
03 GET-BUFFER 
03 GET-HOW-MANY 
03 GET-FIELD 
03 GET-BEGIN 
03 GET-ACTION 
03 GET-ATTRIBUTE. 

05 ATTR-BYTE 

05 FILLER- 



PIC 9 
PIC 9 



COMP-1 
COMP-1 



COMP-1 
COMP-1 



PIC X<64) DISPLAY. 
PIC 9(4) COMP-1. 



PIC 9(4) 
PIC 9(4) 
PIC 9(4) 

PIC X 
PIC X(3) 



COMP-1 . 
COMP-1 . 
COMP-1 . 

DISPLAY. 
DISPLAY. 



Pit 

ph: 

PIC 9(4) 



PIC 9(4) 
PIC 9(4) 



X(64) DISPLAY. 
9(4) COMP-1. 

COMP-1. 

COMP-1 . 

COMP-1. 



PIC X 
PIC X(3> 



DISPLAY. 
DISPLAY. 



01 ATR-BUFFER PIC X(240). 

01 ATR-BUF REDEFINES ATR-BUFFER. 
03 ATR-BU OCCURS 40 TIMES 

INDEXED BY ATR-INDX. 
05 ATR-POS PIC 9(4) CnMP-1. 
05 ATTR-BYTE PIC X DISPLAY. 
05 FILLER PIC X(3) DISPLAY. 



03 ATR-MAXNO 
03 ATR-BEGIN 



PIC 9(2) 
PIC 9(4) 



COMP-1 
COMP-1, 



Figure 5-7. Example COBOL Calls to PSC Routines (Sheet 1 of 3) 
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03 ATR-CURSOR PIC 9(4) COMP-1. 
03 ATR-RETURNED PIC 9(2) COMP-1. 
03 WCC PIC 9(4) COMP-1. 

01 TMO-ARGUMENTS. 

03 TMO-HOW-LONG PIC 9(4) COMP-1. 

01 XMT-ARGUMENTS. 

03 AID-KODE PIC 9(2) COMP-1. 

01 CLS-ARGUMENTS. 

03 REACTIVATE PIC 9 COMP-1. 

01 COMPLETION-KODE PIC 9(4) COMP-1. 

PROCEDURE DIVISION. 

* ..... 

* ■ ..... 

* ..... 

OPN-CALL. 

MOVE O TO ICS-LINE. 

MOVE 05 TO TERM-ADDRESS. 

MOVE ZERO TO ACTIVATE. 

MOVE ZERO TO COMPLETION-KODE. 

CALL "IC*OPN" USING STATION-ADDRESS ACTIVATE DUMMY 

COMPLETION-KODE. 
IF COMPLETION-KODE NOT = ZERO, GO TO ERROR-ROUTINE. 
FIL-CALL. 

MOVE "INFORMATION" TO FILL-BUFFER. 

MOVE 11 TO FILL-HOW-MANY. 

MOVE 1 TO FILL-FIELD. 

MOVE 1 TO FILL-BEGIN. 

MOVE 1 TO FILL-ACTION. 

CALL "IC*FIL" USING STAT I ON- ADDRESS FILL-BUFFER 

FILL-HOW-MANY FILL-FIELD FILL-BEGIN 

FILL-ACTION COMPLETION-KODE FILL-ATTRIBUTE. 
IF COMPLETION-KODE NOT = ZERO, GO TO ERROR-ROUTINE. 
GET-CALL. 

MOVE TO GET-BUFFER. 

MOVE 64 TO GET-HOW-MANY. 

MOVE 1 TO GET-FIELD. 

MOVE 1 TO GET-BEGIN. 

MOVE 3 TO GET-ACTION. 

MOVE TO GET-ATTRIBUTE. 

CALL "IC*GET" USING STATION-ADDRESS GET-BUFFER 

GET-HOW-MANY GET-BEGIN GET-ACTION 

COMPLETION-KODE GET-ATTRIBUTE. 
IF COMPLETION-KODE NOT = ZERO, GO TO ERROR-ROUTINE. 

ATR-CALL. 

MOVE 24 TO ATR-MAXNO. 

MOVE 5 TO ATR-BEGIN. 

CALL "ICSATR" USING STATION-ADDRESS ATR-BUFFER ATR-MAXNO 

ATR-BEGIN ATR-CURSOR ATR-RETURNED COMPLETION-KODE WCC 



Figure 5-7. Example COBOL Calls to PSC Routines (Sheet 2 of 3) 
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IF COMPLETION-KODE NOT = ZERO, GO TO ERROR-ROUTINE. 
TMO-CALL. 

MOVE 2 TO TMO-HOW-LONG. 

CALL "IC*TMO" USING STATION-ADDRESS TMO-HOW-LONG 

COMPLETION-KODE. 

IF COMPLETION-KODE NOT = ZERO, GO TO ERROR-ROUTINE. 
XMT-CALL. 

MOVE 60 TO AID-KODE. 

CALL "IC*XMT" USING STATION-ADDRESS AID-KODE COMPLETION-KODE. 

IF COMPLETION-KODE NOT = ZERO, GO TO ERROR-ROUTINE. 
CLS-CALL. 

MOVE TO REACTIVATE. 

CALL "IC*CLS" USING STATION-ADDRESS REACTIVATE 

COMPLETION-KODE. 

IF COMPLETION-KODE NOT = ZERO, GO TO ERROR-ROUTINE. 



ERROR-ROUTINE. 

MOVE 2 TO REACTIVATE. 

CALL "IC*CLS" USING STATION-ADDRESS REACTIVATE 

COMPLETION-KODE. 
END-PROGRAM. 



Figure 5-7. Example COBOL Calls to PSC Routines (Sheet 3 of 3) 

Either method can be used for a user-written PSC program in any supported language. In addition 
to the modules required specifically for PSC programs, each language requires one or more 
libraries to be referenced in the link control stream. Exactly which modules are required depends 
upon the language utilities you use in your program. Many of these modules are optional. Refer to 
the programmer's manual of the language you are using to find out exactly what modules are 
required for your PSC program. 

The DX10 Link Editor resolves references to the PSC routines when you include the DX10 3270 ICS 
object library directory in your link control stream or when you include each called PSC object 
module and the patch module. The patch object module is referenced by the pathname 
.DXO3270.OBJ.PSCPAT. The patch module is required because it patches the PSC object mod- 
ules. After each relink of your PSC program, you must then apply the patches to the PSC object 
modules before executing your program. The procedure that applies the patches is described in 
paragraph 5.6. To apply the patches, you need to save the link map that the DX10 linker produces 
from your link control stream. 
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C 

C THIS EXAMPLE IS WRITTEN FOR THE FORTRAN 78 COMPILER AND 

C ILLUSTRATES PSC CALLS AND THE ASSOCIATED DATA 

C STRUCTURES. THE SEQUENCE OF THE CALLS IS NOT 

C REPRESENTATIVE OF THE STRUCTURE OF A TYPICAL 

C PSC PROGRAM. 

C 

C 

INTEGER CCODE 
C 

C COMPLETION CODE FOR ALL ARGUMENTS 
C 

INTEGER ADDR<2> 
C 

C CONTROL UNIT ADDRESS AND TERMINAL ADDRESS, <A1> FOR EACH CALL 
C 

CHARACTER * 240 BUFFER 
C 

C ATTRIBUTE BUFFER - <A2> OF FILL AND GET ROUTINES 
C 

INTEGER ATR CHAR (2) 
C 

C ATTRIBUTE CHARACTER FOR FILL, GET AND RETRIEVE ATTRIBUTES ROUTINE 
C 

INTEGER DUMMY 
C 

C DUMMY — <A3> OF OPEN, NOT USED 
C 

INTEGER FILL CNT, FILL FIELD, FILL START 
INTEGER FILL NEXT 
C 

C FILL COUNT, FIELD, START FIELD, AND NEXT ACTION FOR FILL ROUTINE 
C 

INTEGER GET CNT, GET FIELD, GET START, GET NEXT 
C 

C GET COUNT, FIELD, START FIELD, AND NEXT ACTION FOR GET ROUTINE 
C 

INTEGER ATR COUNT, ATR START, ATR CURSOR, ATR TOT, WCC 
C 

C NUMBER OF CHARACTERS REQUESTED, START FIELD, CURSOR LOCATION, 
C NUMBER OF CHARACTERS ACTUALLY RETRIEVED FOR RETRIEVE ATTRIBUTES 
C ROUTINE, AND WCC. 
C 

INTEGER TIME OUT INTERVALS 
C 

C TIME OUT INTERVALS FOR WAIT ROUTINE 
C 

INTEGER TRANSMIT AID CODE 
C 

C AID CODE FOR TRANSMIT ROUTINE 
C 

INTEGER CLS OP 
C ■ 

C TERMINATE/DO NOT TERMINATE ARGUMENT FOR CLOSE ROUTINE 



Figure 5-8. Example FORTRAN Calls to PSC Routines (Sheet 1 of 3) 
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u 

EXTERNAL IFSOPN 
EXTERNAL IFSFIL 
EXTERNAL IFSGET 
EXTERNAL IFSATR 
EXTERNAL IFSTMO 
EXTERNAL IFSXMT 
EXTERNAL IFSCLS 
C 

C DECLARE PSC ROUTINES AS EXTERNAL SUBPROGRAMS 
C 

C OPEN ROUTINE CALL 

C — AUTOSELECT CONTROL UNIT AND CRT TERMINAL ADDRESS, 
C DO NOT ACTIVATE. 

C 

ADDR(1)=>200 
ADDR ( 2 ) =>200 
ACT=0 
DUMMY=0 
CCODE=0 

CALL IFSOPN (ADDR, ACT, DUMMY, CCODE) 
IF (CCODE. NE.O) GO TO 999 
C 

C FILL ROUTINE CALL 
C 

BUFFER- 'Los-on sequence here. - ' 
FILL CNT=20 
FILL FIELD=2 
FILL START=1 
FILL NEXT=1 

CALL IFSFIL (ADDR, BUFFER, FILL CNT,FILL FIELD, FILL START, FILL NEXT, 
X CCODE, ATR CHAR) 

IF (CCODE. NE.O) GO TO 999 
C 

C GET ROUTINE CALL 
C 

GET CNT=80 
GETFIELD=4 
GET START=1 
GET NEXT=0 

CALL IFSGET (ADDR, BUFFER, GET CNT,GET FIELD, GET START, 
X GET NEXT, GET ATTR, CCODE) 
IF (CCODE. NE.O) GO TO 999 
C 

C ATTRIBUTE ROUTINE 
C 

ATR C0UNT=40 
ATR START=10 

CALL I FSATR ( ADDR , ATR BUF , ATR COUNT , ATR START , 
X ATR CURSOR, ATR TOT, CCODE, WCC) 
IF (CCODE. NE.O) GO TO 999 
C 

C TIME-OUT ROUTINE 
C 



Figure 5-8. Example FORTRAN Calls to PSC Routines (Sheet 2 of 3) 
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TIME OUT INTERVALS=2 

CALL IFSTMO(ADDR, TIME OUT INTERVALS, CCODE) 

IF ( CCODE. NE.O) GO TO 999 
C 

C TRANSMIT ROUTINE 
C 

TRANSMIT AID CODE=0 

CALL IFSXMT(ADDR, TRANSMIT AID CODE, CCODE) 

IF (CCODE. NE.O) GO TO 999 
C 

C CLOSE ROUTINE WITH TERMINATE OPTION 
C 
999 CLOSE 0P=2 

CALL IFSCLS(ADDR, CLOSE OP, CCODE) 
C 

END 



Figure 5-8. Example FORTRAN Calls to PSC Routines (Sheet 3 of 3) 



Consider the following three facts when linking the user task: 

• You must assign the PSC task a priority that matches the priority level of the ICSPSC 
task. The ICSPSC task is installed with a priority of three and unless that is modified, 
your user-written PSC task must also be installed with a priority level of three. The 
ICSPSC task is located under the pathname DS01.S$COMMPF. 

• You should not install your PSC task as replicatable if you link the PSC subroutine 
object modules in the procedure segment of your task. If your link control stream speci- 
fies FORMAT IMAGE REPLACE, the link editor installs your program as replicatable. 
The Modify Task Entry (MTE) procedure allows you to change your program to nonrepli- 
catable. Refer to the DX10 Operating System Developmental Operation Manual, Volume 
IV, for information concerning the MTE procedure. 

• If you intend to activate your PSC program with one of the language activation com- 
mands and you want the PSC Emulator to rebid your task, your task must reside in the 
DX10 system program file, S$PROGA. If your program closes the PSC Emulator with the 
Do not terminate option, the PSC Emulator rebids your task when it receives data from 
the ICS line. If your task does not reside in .S$PROGA, however the PSC Emulator 
returns a program file error. 
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PROGRAM PSC_E X AMPLE 5 

(* THIS EXAMPLE ILLUSTRATES PSC CALLS AND ASSOCIATED DATA STRUCTURES. 
THE SEQUENCE OF THE CALLS DOES NOT REFLECT THE TYPICAL STRUCTURE 
OF A PSC PROGRAM. *> 



TYPE 



VAR 



ID 

BUFFER 
ATTR-TYPE = 
ATTR-RECORD= 



ARRAY CO..U OF INTEGER; 
ARRAY CI.. SO 3 OF CHAR ? 
PACKED ARRAY CI.. 8 3 OF BOOLEAN; 
PACKED RECORD 

ADDRESS: INTEGER; 

ATR-BYTE: ATTR_TYPE; 

DUMYl: ATTR-TYPE; 

DUMY2: INTEGER 



ATTR_BUFFER= 



END; 
ARRAY 



CI.. 403 OF attr_record; 



CC : PACKED ARRAY CI.. 20 3 OF CHAR; 

CCODE : INTEGER; 

ADDR : ID; 

B : BUFFER; 

ACT, DUMMY : INTEGER; 

FILL_CNT, FILL-FIELD, FILL-START, 



( *BUFFER MESSAGE* ) 
( *COMPLET I ON CODE* ) 
( *STAT I ON ADDRESS* ) 
(*F ILL/GET DATA*) 
(*OPN PARMS*) 
(*FIL PARMS*) 



FILL-NEXT : INTEGER; FILL-ATTR : ATTR-RECORD; 
GET-CNT, GET-FIELD, GET^START, (*GET PARMS*) 

GET-NEXT : INTEGER; GET-ATTR : ATTR-RECORD; 
ATR-BUF : ATTR-BUFFER? ATR-COUNT, (*ATR PARMS*) 

ATR-START, ATR-CURSOR, ATR-TOT, WCC s INTEGER; 
TIME_OUT_ INTERVALS : INTEGER; (*TMO PARM*) 

TRANSMIT- AID-CODE : INTEGER; <*XMT PARM*) 

CLS-OP : INTEGER? (*CLS PARM*) 



PROCEDURE IFSOPN<VAR A1:ID; VAR A2, A3, A4: Integer); EXTERNAL FORTRAN; 
PROCEDURE IFSFIL<VAR Al:ID; VAR A2: BUFFER? VAR A3, A4, A5, A6, A7: INTEGER? 

VAR AS: ATTR_RECORD)? EXTERNAL FORTRAN; 
PROCEDURE I FSGET ( VAR A 1 : I D ? VAR A2 : BUFFER ? VAR A3 , A4 , A5 , A6 , A7 : I NTEGER ? 

VAR AS: ATTR_RECORD); EXTERNAL FORTRAN? 
PROCEDURE IFSATR(VAR A1:ID? VAR A2: ATTR-BUFFER? VAR A3, A4, A5, A6, A7, AS: 
INTEGER)? EXTERNAL FORTRAN; 
I FSTMO ( VAR A 1 : I D ? VAR A2 , A3 : I NTEGER ) ? 
VAR A2,A3: INTEGER)? 
VAR A2/A3: INTEGER)? 
VAR A2,A3: INTEGER)? 



PROC 
PROC 
PROC 
PROC 



EDURE 
EDURE 
EDURE 
EDURE 
BEG I 
( 

C 

I 

END? 



IFSXMT(VAR Al: ID? 
IFSCLS(VAR Al:ID? 
RPTERR(VAR Al: ID? 



EXTERNAL FORTRAN? 
EXTERNAL FORTRAN? 
EXTERNAL FORTRAN? 



N 

* REPORT ERROR CONDITION TO SOME RETRIEVABLE STRUCTURE*) 

LS_OP := 2? (*ALWAYS CLOSE PSC EMULATOR WITH TERMINATE OPTION*) 

FSCLS(ADDR, CLS-OP, CCODE) 



BEGIN 



OPEN: BEGIN 

ADDR C03 = =#0200 ? ADDR CI]: =#0200 ? ( *STAT I ON ADDRESS : AUTOSELECT 



Figure 5-9. Example Pascal Calls to PSC Routines (Sheet 1 of 2) 
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TYPE CRT*) 

ACT:=Oi (♦set activation variable to zero^ 

DUMMY: =0? (♦DUMMY ARGUMENT*) 

CCODE: =0; <*SET COMPLETION CODE TO ZERO*) 

I FSOPN ( ADDR , ACT , DUMMY , CCODE ) ; ( *CALL OPEN ROUT I NE* ) 

IF CCODE O THEN RPTERR ( ADDR , CLS-OP , CCODE ) 

(♦REPORT ERROR PROCEDUE*) 
END? 

FILL: BEGIN 

B::CC:='Please Enter Your ID' S (♦MESSAGE TO PUT IN STATION BUFFER* 
FILL_CIMT:=20; FILL-FIELD: =2" (♦TWENTY CHARACTERS TO FIELD TWO* 
FILL_START:=1" FILL_NEXT: =1 ; (*START AT POSITION ONE, TRANSMIT^ 
I FSF I L ( ADDR , B , F I LL-CNT , F I LL_F I ELD , F I |_L_ST ART , F I LL-NEXT , CCODE , F I LL. 
TR)S 

IF CCODE O THEN RPTERR (ADDR, CLS-OP, CCODE) 

(♦REPORT ERROR PROCEDUE*) 
ENDS 

GET: BEGIN 

GET_CNT:=80; GET-FIELD: =4; (*EIGHTY CHARACTERS FROM FIELD FOl 
) 

GET-START: =1; GET_NEXT: =01 ; ( *START AT POSITION ONE, NO ACTIOr 
IFSGET ( ADDR, B, GET-CNT, GET-FIELD, GET-START, GET-NEXT, CCODE, GET-ATTR . 
IF CCODE O THEN RPTERR (ADDR, CLS-OP, CCODE) 

(♦REPORT ERROR CONDITION*) 
ENDS 

ATTRIBUTE: BEGIN 

ATR_C0UNT:=40; ATR-START: =10; (*FORTY ATTRIBUTES, START > I ELD K. 
IFSATR( ADDR, ATR-BUF, ATR-COUNT, ATR-START, ATR-CURSOR, ATR-TOT, CCODE, I 
); 

IF CCODE O THEN RPTERR ( ADDR, CLS-OP, CCODE) 

(♦REPORT ERROR PROCEDUE* ) 
END; 

TIME_OUT: BEGIN 

TIME_OUT_ INTERVALS: =2; (*WAIT TWO 50 MSEC INTERVALS*) 

I FSTMO ( ADDR , T I ME_OUT_ I NTER V ALS , CCODE ) ? 

IF CCODE O THEN RPTERR ( ADDR, CLS-OP, CCODE) 

(*REPORT ERROR PROCEDUE*) 
END; 

TRANSMIT: BEGIN 

TRANSM I T_A ID_CODE: =#60; (*SET AID CODE TO 60 HEXADECIMAL* 

I FS XMT ( ADDR , TRANSM I T_ A I D..CODE , CCODE ) ; 

IF CCODE O THEN RPTERR ( ADDR, CLS-OP, CCODE) 

(♦REPORT ERROR PROCEDURE*) 
END ; 

CLOSE: BEGIN 

I FSCLS ( ADDR , CLOSE_OP , CCODE ) ; 

IF CCODE <> THEN RPTERR ( ADDR, CLS-OP, CCODE ) 

(♦REPORT ERROR PROCEDUE*) 
END? 

(* OTHER ROUTINES AND CODE... *) 

END. 



Figure 5-9. Example Pascal Calls to PSC Routines (Sheet 2 of 2) 
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IDT -PSCEX- 



# 






* THE FOLLOWING REF : 


* 


INSTRUCTIONS TO 


•a 








REF 


IC*OPN 




REF 


ICSFIL 




REF 


IC*GET 




REF 


IC*XMT 




REF 


IC*TMO 




REF 


IC*ATR 


•s- 


REF 


IC*CLS 


■a 


SET-UP ARGUMENT 


* 






OPNARG 


DATA 


4*2 




DATA 


OPN1 




DATA 


OPN2 




DATA 


0PN3 




DATA 


OPNCC 


*• 






FILARG 


DATA 


8*2 




DATA 


FIL1 




DATA 


FIL2 




DATA 


FIL3 




DATA 


FIL4 




DATA 


FIL5 




DATA 


FIL6 




DATA 


FILCC 




DATA 


FIL8 


* 






GETARG 


DATA 


8*2 




DATA 


GET1 




DATA 


GET2 




DATA 


GETS 




DATA 


GET4 




DATA 


GETS 




DATA 


GET6 




DATA 


GETCC 




DATA 


GETS 


■H- 






ATRARG 


DATA 


ft#o 




DATA 


ATR1 




DATA 


ATR2 




DATA 


ATR3 




DATA 


ATR4 




DATA 


ATR5 




DATA 


ATR6 




DATA 


ATRCC 




DATA 


wee 


* 






TMOARG 


DATA 


3*2 




DATA 


TMOl 




DATA 


TM02 


Figure 5-10. 


Exa 


mple 990 Ass 



STATEMENTS ARE USED FOR THE BLWP 
THE PSC RUN-TIME MODULES. 

OPEN ROUTINE 

FILL ROUTINE 

GET ROUTINE 

TRANSMIT ROUTINE 

TIME-OUT ROUTINE 

RETRIEVE ATTRIBUTES ROUTINE 

CLOSE ROUTINE 

LISTS 

FOUR TWO-BYTE POINTERS 
STATION ID POINTER 
ACTIVATION FLAG POINTER 
DUMMY POINTER 
COMPLETION CODE POINTER 

EIGHT TWO-BYTE POINTERS 
STATION ID POINTER 
STATION BUFFER PO INTER- 
LENGTH OF FILL POINTER 
FIELD NUMBER POINTER- 
POSITION POINTER 
NEXT ACTION POINTER 
COMPLETION CODE POINTER 
ATTRIBUTE POINTER 

EIGHT TWO-BYTE POINTERS 
STATION ID POINTER 
STATION BUFFER POINTER 
LENGTH OF GET POINTER 
FIELD NUMBER POINTER- 
POSITION POINTER 
NEXT ACTION POINTER- 
COMPLETION CODE POINTER 
' ATTRIBUTE POINTER 

EIGHT TWO-BYTE POINTERS 
STATION ID POINTER 
ATTRIBUTE BUFFER POINTER- 
NUMBER OF ATTRIBUTES POINTER 
FIRST FIELD POINTER 
CURSOR ADDRESS POINTER- 
NUMBER OF ATTRIBUTES RECEIVED POINTER- 
COMPLETION CODE POINTER 
WCC OF CURRENT SCREEN IMAGE 

THREE TWO-BYTE POINTERS 
STATION ID POINTER 
TIME-OUT POINTER 



Example 990 Assembly Language Calls to PSC Routines (Sheet 1 of 3) 
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XMTARG 



CLSARG 



* 

0PN1 

CCODE 
•a 

•8- 

PSCBUF 

ATTR 

■a 

* 

OPN1 

0PN2 
0PN3 
OPN4 



•a 
FIL1 

FIL2 

FIL3 

FIL4 

FIL5 

FIL6 

FILCC 

FIL8 



DATA TMOCC 

DATA 3*2 
DATA XMT1 
DATA XMT2 
DATA XMTCC 

DATA 3*2 
DATA CLS1 
DATA CLS2 
DATA CLSCC 



COMPLETION CODE POINTER 

THREE TWO-BYTE POINTERS 
STATION ID POINTER 
AID CODE POINTER 
COMPLETION CODE POINTER 

THREE TWO-BYTE POINTERS 
STATION ID POINTER 
TERMINATE FLAG POINTER- 
COMPLETION CODE POINTER 



VARIABLES USED BY ALL PSC ROUTINES 



DATA >20 
DATA >30 
DATA O 



ICS LINE — AUTO-SELECT CU ADDR 
TERMINAL ADDRESS — AUTO-SELECT CRT 
COMPLETION CODE 



VARIABLES SHARED BY GET AND FILL ROUTINES 



BSS 240 
BSS 4 

CALL OPEN ROUTINE 



RESERVE 240 BYTES OF MEMORY FOR BUFFER 
RESERVE TWO WORDS OF MEMORY FOR ATTRIBUTE INFO 



DATA 6 
DATA 16 
DATA 1 
DATA 
DATA O 



ICS CHANNEL 

POLL ID 

ACTIVATE INTERFACE 

DUMMY ARGUMENT 

COMPLETION CODE 



LI RO,OPNARG PARAMETER LIST POINTER 
BWLP eiC$OPN SUBROUTINE LINKAGE 



CALL FILL ROUTINE 



GET! 



DATA 6 

DATA 16 

DATA PSCBUF 

DATA 10 

DATA 1 

DATA 1 

DATA 

DATA 

BYTE 

BYTE 

BYTE 

BYTE 

LI RO.FILARG 

BLWP @IC$FIL 

CALL GET ROUTINE 



ICS CHANNEL 

POLL ID 

ADDRESS OF FILL DATA 

LENGTH OF FILL DATA 

FIRST FIELD 

FIRST POSITION 

NO ADDITIONAL ACTION 

COMPLETION CODE 

ATTRIBUTE BYTE 

RESERVED FOR 

FUTURE 
ENHANCEMENTS 
PARAMETER LIST POINTER 
SUBROUTINE LINKAGE 



DATA 6 
DATA 16 



ICS CHANNEL 
POLL ID 



Figure 5-10. Example 990 Assembly Language Calls to PSC Routines (Sheet 2 of 3) 
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GET2 

GET3 

GET4 

GETS 

GET6 

GETCC 

GETS 



ATR1 

ATR2 

ATR3 

ATR4 

ATR5 

ATR6 

ATRCC 

WCC 

# 

•M- 
•M- 

TM01 

TM02 
TMOCC 



•a- 
•a- 
•a- 
XMT1 

XMT2 
XMTCC 



•a- 
■a- 
* 
CLS1 

CLS2 
CLSCC 



DATA FLDBUF 

DATA SO 

DATA 2 

DATA 1 

DATA 3 

DATA 

BYTE 

BYTE 

BYTE 

BYTE 

LI RO,GETARG 

BLWP eiC*GET 



ADDRESS FOR DATA BUFFER 
LENGTH OF DATA 
START IN SECOND FIELD 
FIRST POSITION 
CLEAR BUFFER 
COMPLETION CODE 
ATTRIBUTE BYTE 
RESERVED FOR 

FUTURE 
ENHANCEMENTS 
PARAMETER LIST POINTER 
SUBROUTINE LINKAGE 



CALL ATTRIBUTE ROUTINE 

DATA 6 ICS CHANNEL 

DATA 16 POLL ID 

DATA ATRBUF ADDRESS FOR ATTRIBUTE BUFFER 

DATA 20 RETRIEVE TWENTY ATTRIBUTES 

DATA 10 STARTING WITH TENTH FIELD 

DATA RECEIVE CURSOR POSITION 

DATA O RECEIVE COUNT OF FIELDS 

DATA COMPLETION CODE 

DATA WCC OF CURRENT SCREEN 

CALL TIME-OUT ROUTINE 



DATA 6 

DATA 16 

DATA 2 

DATA O 

LI RO,TMOARG 

BLWP @IC*TMO 



ICS CHANNEL 
POLL ID 
INTERVAL IN MS- 
COMPLETION CODE 
PARAMETER LIST POINTER 
SUBROUTINE LINKAGE 



CALL TRANSMIT ROUTINE 



DATA 6 

DATA 16 

DATA 2 

DATA 

LI RCXMTARG 

BWLP @IC*XMT 



ICS CHANNEL 
POLL ID 
AID CODE 
COMPLETION CODE 
PARAMETER LIST PO INTER- 
SUBROUTINE LINKAGE 



CALL CLOSE ROUTINE 



DATA 6 

DATA 16 

DATA 

DATA 

LI RO,CLSARG 

BLWP @IC*CLS 



END 



ICS CHANNEL 

POLL ID 

ALLOW REACT I VAT I ON 

COMPLETION CODE 

PARAMETER LIST POINTER 

SUBROUTINE LINKAGE 



Figure 5-10. Example 990 Assembly Language Calls to PSC Routines (Sheet 3 of 3) 
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The actual pathnames of the PSC object modules vary depending on whether you received ICS on 
disk media as opposed to magnetic tape media or as an add-on package. If you received the object 
as an add-on package or on magnetic tape media, the object library directory pathname is as 
follows: 

.DXO3270.OBJ 

If you received ICS on disk media, the object library directory pathname is as follows: 

You can place the object library on any available disk media that you desire. If you plan to do 
extensive PSC development work on your system, it is recommended that you copy the necessary 
ICS object modules onto a permanently installed disk. If you relocate the object library, remember 
that you must use the new pathname in the link control stream. The following examples assume 
that the object library directory is DXO3270.OBJ. 

Example 1 shows a PSC link control stream for a FORTRAN program using the library method. 

EXAMPLE 1 

FORMAT IMAGE,REPLACE, 3; ASSIGN PRIORITY LEVEL 3 

LIBRARY .FORTRN.OSLOBJ; STANDARD FORTRAN LIBRARY DIRECTORY 

LIBRARY .FORTRN.STLOBJ; STANDARD FORTRAN LIBRARY DIRECTORY 

LIBRARY DXO3270.OBJ; DX103270 ICS LIBRARY DIRECTORY 

PHASE O.MYPSCTSK; ROOT, TASK NAME MYPSCTSK 

INCLUDE .OBJECT.MYPSCTSK; USER-WRITTEN PSC PROGRAM 

END 

The library method is the easiest to use since you do not have to reference each module individu- 
ally. Only those PSC object modules your program uses are included. One disadvantage to the 
library method is that the execution of the Link Editor is slightly slower than when you use individ- 
ual INCLUDE statements. Example 2 shows the same link control stream using the module 
method. 



NOTE 

When using Tl Pascal, the DXO3270 object library should be the last 
library included in your link control stream. 
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FORMAT IMAGE,REPLACE,3; 
LIBRARY .FORT78.0SLOBJ; 
LIBRARY .FORT78.STLOBJ; 
TASK MYPSCTSK; 
INCLUDE DXO3270.OBJ.PSCPAT; 
INCLUDE DXO3270.OBJ.IFSOPN; 
INCLUDE DXO3270.OBJ.ICSOPN; 
INCLUDE DXO3270.OBJ.ICSFIL; 
INCLUDE DXO3270.OBJ.ICSGET; 
INCLUDE DXO3270.OBJ.ICSXMT; 
INCLUDE DXO3270.OBJ.ICSATR; 
INCLUDE DXO3270.OBJ.ICSCLS; 
INCLUDE DXO3270.OBJ.ICSTMO; 
INCLUDE DXO3270.OBJ.IPCSUB; 
INCLUDE DXO3270.OBJ.THCBAS; 
INCLUDE DXO3270.OBJ.THCONS; 
INCLUDE .OBJECT.MYPSCOBJ; 
END 



ASSIGN PRIORITY LEVEL 3 

STANDARD FORTRAN DIRECTORY 

STANDARD FORTRAN DIRECTORY 

PSC ROUTINES INCLUDED IN TASK SEGMENT 

PSC PATCH MODULE 

FORTRAN/PASCAL INTERFACE ROUTINE 

ICS PSC OPEN ROUTINE 

ICS PSC FILL ROUTINE 

ICS PSC GET ROUTINE 

ICS PSC TRANSM IT ROUTI N E 

ICS PSC RETRIEVE ATTRIBUTES ROUTINE 

ICS PSC CLOSE ROUTINE 

ICS PSC TIME-OUT ROUTINE 

ICS IPC ROUTINES 

ICS PSC TASK VARIABLES 

ICS PSC TASK CONSTANTS 

USER-WRITTEN PSC OBJECT MODULE 



Note that two of the libraries referenced are specifically required for FORTRAN programs. Refer to 
the programmer's guide of the language you are using to determine which libraries or modules are 
required for your program. If you use the library method and do not use every PSC routine, the Link 
Editor returns warnings to indicate that your task does not reference some object modules that 
the DXO3270 library defines. Provided that your task does not use these modules, you can ignore 
these warnings. For further information concerning the Link Editor refer to the Link Editor Refer- 
ence Manual. 



5.6 PATCH ICS PSC USER TASK — PTPSC 

The following paragraphs describe how to apply the current patches to the PSC routines linked 
with your PSC program. You must perform this procedure after each relink of you^program before 
you can successfully execute your PSC program. It is assumed that you included the object mod- 
ule DXO3270.OBJ.PSCPAT (patch module) in your link control stream or that you used the library 
method when linking. If you have relocated the ICS object library, the first element (or elements) of 
this pathname are different. Use the pathname that defines the current location of this library. It is 
also assumed that the object modules for the PSC routines were included in the task segment of 
your program. If you link the PSC run-time modules into a nonreplicatable procedure, to apply the 
PSC patches, you must generate a special link map that designates this procedure segment as a 
task segment. PTPSC assumes that the run-time is linked in the task segment. 
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ICS provides a procedure that executes a batch stream that applies the current patches to the 
object modules of the PSC routines. Patches are sent with each new update of ICS. To apply the 
latest patches to the PSC routines, enter PTPSC in response to the SCI prompt. The following dis- 
play appears: 

[ ] PTPSC 

EMULATOR OBJECT PATHNAME: 

LISTING ACCESS NAME: 

PSC USER LINKMAP: 

PSC USER PROGRAM FILE: 

PSC USER TASK NAME: 

The command prompts and appropriate responses are as follows: 

EMULATOR OBJECT PATHNAME 

Enter the pathname of the library where the ICS PSC patch file resides. Remember where you 
store this patch file when you receive it from your customer representative. If your customer 
representative has sent you no new patch files since you received ICS, you must still apply 
the PSC patches that accompany the ICS release that you received. This patch file is located 
under the pathname < ICS object> .PAT .PSC3270, where < ICS object> represents the direc- 
tory containing the ICS object directory. 

LISTING ACCESS NAME 

Enter the name of the file where the PTPSC procedure writes the patch listing. Upon comple- 
tion of this procedure, examine this file to determine if any errors occurred. The volume and 
libraries specified in the pathname must already exist, and the library under which the file is 
to be written must have space for one more file. If these conditions are met, the listing file is 
automatically created. 

PSC USER LINKMAP 

Enter the pathname of the file containing the link map generated when you linked your PSC 
program. That pathname should be the same pathname specified as the LISTING ACCESS 
NAME when you perform the Execute Link Editor (XLE) command. 

PSC USER PROGRAM FILE 

Enter the name of the program file in which the user task resides. 

PSC USER TASK NAME 

Enter the name of the PSC task that you wrote. This is the same name used in the PHASE or 
TASK statement of your link control stream. 

Upon completion of the patch application, the following message is written to the station where 
the procedure was invoked: 

ICSPSC USER TASK PATCH PROCESS COMPLETE 
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When this message appears, examine the listing file you specified to determine if any errors 
occurred. Refer to the DX10 Operating System Error Reporting and Recovery Manual, Volume 
VI, to discover the meaning of any errors returned. If any errors occur, correct the problem 
and re- execute the procedure. If no errors occur, you are ready to execute your PSC program. 



5.7 EXECUTE PSC TASK — XPSC 

The SCI command procedure XPSC bids a PSC task to run in the background mode. Enter XPSC in 
response to the SCI prompt. The following display appears: 

[ ] XPSC 

EXECUTE ICS PROGRAMMED STATION CONTROL 
COMMUNICATIONS LINE NAME 
TERMINAL ADDRESS (0-31 ) 
TERMINAL TYPE ( CRT/ PRT) 
USER PROGRAM FILE ACNM: .PSCUSR 
USER TASK NAME: USRAPPL 

If you enter null values in response to the COMMUNICATIONS LINE NAME and the TERMINAL 
ADDRESS(0-31) prompts, ICS automatically selects them for you provided that you specify the 
type of terminal address that your program requires. If you do not specify the type of terminal 
address required, ICS cannot automatically select the communications line name and an avail- 
able terminal address. 

The user-written PSC program can also select these addresses in the Open call. If your program 
specifies values for the communications line name or terminal address in <a1> for all the PSC 
call statements, you must specify the same values when executing the XPSC command. You can 
use a control unit address in <a1> and a communications line name during XPSC if they both 
identify the same ICS communications line. If you specify auto-select by using a null value when 
executing XPSC, you must also specify auto-select in <a1> for all the PSC routine call state- 
ments. In both cases, you must specify the terminal type. You must specify the program file name 
and task name or ID to identify the user-written task to be bid. 

To specify the operation for your data entry personnel, you may wish to create your own command 
procedure for activating each PSC task installed on your system. Modify the XPSC procedure by 
placing the required values for your PSC task in the parameters used in the bid primitive. Remem- 
ber not to duplicate the name of an installed SCI command procedure when naming your 
customized procedure. 
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You can also use one of the following language activation procedures provided by the DX10 oper- 
ating system: 



Command Procedure 



Description 



Execute Task (XT) 



Activates any program 



Execute Pascal Task (XPT) 



Activates a Pascal program 



Execute COBOL Task (XCT) 



Activates a COBOL program 



Execute FORTRAN Task (XFT) 



Activates a FORTRAN program 



If you use one of these procedures to activate your PSC program, your program must provide the 
parameters that the XPSC command prompts identify by using the PSC routine call arguments. If 
your program issues a Close call specifying Do not terminate, the PSC Emulator attempts to rebid 
your program when it receives data from the ICS line. If you activate your program by using one of 
the language activation procedures and your program subsequently issues a Close call that speci- 
fies Do not terminate, the PSC Emulator can only rebid your task if you installed it in the 
.S$PROGA system program file. 
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Generic keycap names that apply to all terminals are used for keys on keyboards throughout this 
manual. This appendix contains specific keyboard information to help you identify individual keys 
on any supported terminal. For instance, every terminal has an Attention key, but not all Attention 
keys look alike or have the same position on the keyboard. You can use the terminal information in 
this appendix to find the Attention key on any terminal. 

The terminals supported are the 931 VDT, 911 VDT, 915 VDT, 940 EVT, the Business System 
terminal, and hard-copy terminals (including teleprinter devices). The 820 KSR has been used as a 
typical hard-copy terminal. The 915 VDT keyboard information is the same as that for the 911 VDT 
except where noted in the tables. 

Appendix A contains three tables and keyboard drawings of the supported terminals. 

Table A-1 lists the generic keycap names alphabetically and provides illustrations of the 
corresponding keycaps on each of the currently supported keyboards. When you need to press 
two keys to obtain a function, both keys are shown in the table. For example, on the 940 EVT the 
Attention key function is activated by pressing and holding down the Shift key while pressing the 
'key labeled PREV FORM NEXT. Table A-1 shows the generic keycap name as Attention, and a 
corresponding illustration shows a key labeled SHIFT above a key named PREV FORM NEXT. 

Function keys, such as F1, F2, and so on, are considered to be already generic and do not need 
further definition. However, a function key becomes generic when it does not appear on a certain 
keyboard but has an alternate key sequence. For that reason, the function keys are included in the 
table. 

Multiple key sequences and simultaneous keystrokes can also be described in generic keycap 
names that are applicable to all terminals. For example, you use a multiple key sequence and 
simultaneous keystrokes with the log-on function. You log on by pressing the Attention key, then 
holding down the Shift key while you press the exclamation (!) key. The same information in a table 
appears as Attentionl(Shift)!. 

Table A-2 shows some frequently used multiple key sequences. 

Table A-3 lists the generic names for 91 1 keycap designations used in previous manuals. You can 
use this table to translate existing documentation into generic keycap documentation. 

Figures A-1 through A-5 show diagrams of the 911 VDT, 915 VDT, 940 EVT, 931 VDT, and Business 
System terminal, respectively. Figure A-6 shows a diagram of the 820 KSR. 
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Table A-1 . Generic Keycap Names 



Generic Name 



911 
VDT 



940 
EVT 



931 
VDT 



Business 
System 
Terminal 



820 1 
KSR 



Alternate 
Mode 



ALT 



13 



ALT 

Mi 



Attention 2 





/ kiijiisjjw 







l: 



Back Tab 



None 



2 S 



:a 



SHIFT O 



None 




TAB 



Command 2 





CMOjl 



^^5 









Control 







CTRL 1 


ifr" : ' -*i 



tfi .Ta 



Delete 
Character 



GEL 
K3HAH 



Zil 




V N 



DEL js 
CHARli 



^ * 



l: 



None 



Enter 



Z 5 



^ ^ 



1^ N 



(3 



Erase Field 



ERASE 
FISLD 



!• Si 




jy^^^ 



ERASE 
PIEUT 



i| 



^ ^ 






Notes: 

'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPD Device Service 
Routine (DSR). Keys on other TPD devices may be missing or have different functions. 

2 On a 915 VDT the Command Key has the label F9 and the Attention Key has the label F10. 
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Table A-1 . Generic Keycap Names (Continued) 



Generic Name 



Erase Input 



Exit 



Forward Tab 



F1 



F2 



F3 



F4 



911 
VDT 



<r- — 7 


EBASgt 
INPUT j| 


c i 



< 


3 




ESC 1 


£ 






TAB 
SKIP 



F1 



iUiiiiitftfiiittaiiiittMi 



F2 



^— — — — 



mmmmm i 



F3 



V 


/ 




' ■ 






F4 






f - 


mJL 





940 
EVT 





m 



^^^^j 



1^1 III ^ 



V^ — H 



931 
VDT 



r 






ERASE 
INPUT 


c 





skiptO 

miMiiiininiiimiiiiSl 



Fi 



ESC 



V V 



TAB 



L F2 J 



F3 


C 2S 



k A 



Business 
System 
Terminal 









r^ >i 





n * 




Cmmmmmmm 



B 

* 



Notes: 



'The 820 KSR terminal has been used as a typical hard copy terminal 
Routine (DSR). Keys on other TPD devices may be missing or have diffc: 



with the TPD Device Service 
rent functions. 
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820 1 
KSR 



^^H 
w ^ 



n 



N 



^^B 

l-^5 



M 



LZ 



k A 

B 






umm 



^ * 






i — % 

D 
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Table A-1 . Generic Keycap Names (Continued) 



Generic Name 



911 
VDT 



940 
EVT 



931 
VDT 



Business 
System 
Terminal 



820 1 
KSR 



F5 



i : tm 



m 




kTZ2 



F6 



'tm 




c 


F6 J 



11 














iH 






















< 


71 




i 


-a 



F7 



F7 



S 



mF»$i 




V 



F8 




IF8 




L™ 






F9 






I K 

H re 

' * 




\srm 



F10 





_F10 ._ 
l/*— — *\1 
f ■ 




I* 




lr— N 



Z 



Notes: 

'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPD Device Service 
Routine (DSR). Keys on other TPD devices may be missing or have different functions. 
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Table A-1 . Generic Keycap Names (Continued) 



Generic Name 



911 
VDT 



940 
EVT 



931 
VDT 



Business 
System 
Terminal 



820 1 
KSR 



F11 





PIT 



v — >J 




fv J 

rrj 




mZTI 



K A 






F12 



■ 






i — i 

F12 I 


' ■■* 




BU^iiAiiiA^^iHaiMMdyilililiiMliittMiiik«te 



flB| 



BS 



L£=Z&i 



F13 





SHIFT O 






M 



S 

i^^^ 



■^ — ^ 



I 

3 I 



1^ N 



w 



F14 





SHIFT O 




V 



PI 



■ 

iff i i i nrft 



lizda 




rz^i 



^ — ^ 



h^-^A 



v — N 



Home 



HOME 



v — M 



Mil 



HOME 



a 


^ 


1 


1 



H 



1^=31 



l' M 



Initialize Input 




** m 







3 












> — i' 




Notes: 

'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPD Device Service 
Routine (DSR). Keys on other TPD devices may be missing or have different functions 
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Table A-1 . Generic Keycap Names (Continued) 



Generic Name 



911 
VDT 



940 
EVT 



931 
VDT 



Business 
System 
Terminal 



820 ' 
KSR 



Insert 
Character 



\, 



GMAR 




INS 
CHAR 



Next 
Character 





f i 1 



None 



Next Field 




shiftO 




Next Line 




mm 



|^ 



■ 



l^^l^i 






Z 5 


line}; 
feedJi 


/_> 



Previous 




v-^ 


Character 




£rad 



l^zzal 



a 






CHAR 



Previous Field 



fc£ 




FIELD 



L£=d 



Notes: 

'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPD Device Servn 
Routine (DSR). Keys on other TPD devices may be missing or have dif ferent (unctions 
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Table A-1 . Generic Keycap Names (Continued) 



Generic Name 



911 
VDT 



940 
EVT 



931 
VDT 



Business 
System 
Terminal 



820 1 
KSR 



Previous Line 




LZ 



M 




^^H 



& 



Print 




PRINT 

i s * A 



Q 

^^^^^^S 



Repeat 



epeAT 



See 
Note 3 



See 
Note 3 



See 
Note 3 



Return 










1 


v 




i H 


RETURN | 





Shift 




tjtfjjj&jjjjj^itiitiiijiMiim 




SHtFT OJ 





Skip 



ZZ^i 



TAB 

SKIP 




HiaSSSEiis 



in 

SKIPS 




Uppercase 
Lock 





CAPS 
LOCK 



|£ 



^ * 



B 



Notes: 

'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPD Device Service 
Routine (DSR). Keys on other TPD devices may be missing or have different functions 

3 The keyboard is typamatic, and no repeat key is needed. 
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Table A-2. Frequently Used Key Sequences 



Function Key Sequence 



Log-on Attention/(Shift)! 

Hard-break Attention/(Control)x 

Hold Attention 

Resume Any key/any key 



Table A-3. 911 Keycap Name Equivalents 



911 Phrase Generic Name 



Blank gray Initialize Input 

Blank orange Attention 

Down arrow Next Line 

Escape Exit 

Left arrow Previous Character 

Right arrow Next Character 

Up arrow Previous Line 
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EF1 1 f F2 1 f F3 | I F4 1 I F5 | T F6 
mz^kmzzM k*rf \mmM UmJI V»r* 



K F7 F8 

^— ilk— i 





CURSOR CONTROL 
AND EDIT 



v 
DATA ENTRY 



NUMERIC PAD 
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Figure A-1 . 91 1 VDT Standard Keyboard Layout 
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■v 



2284734 (10/14) 



DATA ENTRY 
KEYS 



o 

CO 

<b 
o 



Figure A-2. 915 VDT Standard Keyboard Layout 



FUNCTION 
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STATUS LEDS 
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S If Tff JCy'I 



5ET 
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LINES 
FEEDS 










fi^->' 


1' 


EX 


1 I 
T 


LI 


|ftfi 


v 

M : 


l «j 


'«" 


i^k^^^^i 






b! 


Ihom 


e] 
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f| 


llj 


In1 


'"""" r " r " nr MO^MAMM. 









BjmJB 





25 



MARGIN 
LEFT RIGHT RE LEASE CLEAR 
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Figure A-3. 940 EVT Standard Keyboard Layout 
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Figure A-4. 931 VDT Standard Keyboard Layout 
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Figure A-5. Business System Terminal Standard Keyboard Layout 



O 



> 

CO 



> 



O 

OS 

O 



7\ 



© 

B 




© 

B 




7T1 


+ space! 


TAB 


i-J 


Ill 


T9] 


frl 


4] 

[Tj 




[6J 

[3j 


s — < 


( |! 


■>.........« 









2284734 (14/14) 



Figure A-6. 820 KSR Standard Keyboard Layout 



Appendix B 
ICS Messages and Codes 



B.1 INTRODUCTION 

This appendix lists all the messages that ICS generates. These messages are divided into the fol- 
lowing three groups: 

• Messages returned to a station or log file 

• Internal device service routine (DSR) supervisor call (SVC) error codes 

• Programmed Station Control (PSC) codes returned to the user-written PSC task 

This appendix provides an explanation of each message and the source of each variable parts. 
Corrective action is recommended where the message indicates an error condition. Some ICS 
messages return internal DSR errors as SVC return codes. Table B-1 lists the meaning of each 
internal DSR error code. 

B.2 MESSAGES RETURNED TO ICS STATION OR SYSTEM LOGGING DEVICE 

ICS displays its messages on the bottom line of video terminals in use as ICS stations. ICS also 
writes messages to the system logging device when no video terminals are associated with ICS 
operation. For instance, if an error occurs while an ICS line is active but no video terminal 
addresses on that line are active, ICS writes the error message to the system log. 

Usually, the messages occur when you invoke an SCI command that controls ICS. In these cases, 
ICS writes the messages at the terminal where you enter the command. The SCI command 
procedure that you use is identified by a prefix consisting of an asterisk, the SCI command, 
and a dash— . An example of this message format is as follows: 

•XICT-TERMINAL ADDRESS 05 BELONGS TO A PRINTER: 

The *XICT portion of the message indicates that the error occurred while using the Execute Inter- 
active Communications Terminal (XICT) command. Most of the error messages use variants. In the 
previous example, 05 is a variant. You enter this value in response to a prompt; the program finds 
it unacceptable and returns it as part of the error message. In addition to user-entered variants, 
ICS returns variant values such as internal, SVC, and SCI error codes. The explanations of the 
error messages in this appendix identify the type of each variant. To find the meaning of a 
particular value of an internal communications DSR SVC error code, see paragraph A.3. For fur- 
ther information on an SCI error code, refer to the DX10 Operating System Error Reporting and 
Recovery Manual, Volume VI. 
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When ICS sends one of these messages to the system log file or device, the Julian date and time 
precede the message. ICS provides an additional prefix for some messages to indicate the com- 
munications line and terminal address associated with the error. This prefix is of the following 
general form: 

CMxx,TMyy 
where: 

xx represents the numerical portion of the communications device 
name 

yy represents the decimal value for the terminal address 

The text of these messages can be modified by the systems programmer. Release Information, 
DX10 3270 ICS contains instructions for modifying ICS messages. 

The following discussion lists and explains all the ICS messages. Variants are identified by their 
general type. For example, CM03 is a communications device name. The messages in this appen- 
dix are listed in alphabetical order without the prefix. Two ICS error messages begin with variants. 
The explanations for these messages are at the end of the list, alphabetized by the second ele- 
ment of the message. 

ALL ICS COMMUNICATIONS LINES ARE ACTIVE: 

You executed the Execute Interactive Communications Controller (XICC) command and 
entered no response to the COMMUNICATIONS LINE NAME prompt. ICS searches a list 
of installed ICS lines and tries to select the first inactive installed line. ICS displays this 
message when all installed ICS communications lines are already active. You cannot 
activate a line that is already active. 

ALL ICS PRINTER ADDRESSES ARE IN USE: 

You entered a null value for the TERMINAL ADDRESS(0-31) prompt while using the 
Execute Interactive Communications Printer (XICP) command. The ICS task searches 
for an available printer terminal address, finds none, and displays this message at your 
terminal. Verify this by executing the List Interactive Communications Configuration 
(LICC) command. The configuration listing shows all the reserved terminal addresses, 
their type (CRT or PRT), and their current state (active, suspended, idle, disabled, active 
PSC, or waiting PSC). 

ALL ICS VIDEO ADDRESSES ARE IN USE: 

ICS displays this message at your terminal. No ICS video terminal video terminal 
addresses are available. The List Interactive Communications Configuration (LICC) 
command returns a list of installed terminal addresses, their types (CRT or PRT), and 
their current states (active, suspended, idle, disabled, active PSC, or waiting PSC). Wait 
until one of the currently active or suspended ICS stations terminates. 



B-2 2250954-9701 



ICS Messages and Codes 



CANNOT MODIFY CONTROL UNIT ADDRESS FOR ACTIVE ICS LINE xx: 

You attempted to modify the control unit address assigned to the ICS line identified by 
xx. This line is active, and ICS does not allow you to modify the control unit address of 
an active line. You should perform this modification immediately after the initial pro- 
gram load (IPL) and before activating the ICS line. ICS displays this message at the ter- 
minal at which you entered the modify interactive communications configuration 
(M ICC) command. 

CANNOT MODIFY ICS CONFIGURATION FOR ACTIVE LINE xx: 

You attempted to modify the configuration of the ICS line identified by xx. This line is 
currently active, and ICS does not allow you to modify the state or type of a terminal 
address assigned to an active line. ICS displays this message at the terminal where you 
entered the MICC command. You should perform this modification immediately after 
the initial program load (IPL) and before activating the ICS line. 

CANNOT MODIFY LAST CRT ADDRESS: 

At least one terminal address on each installed ICS line must be of the CRT (video) type 
and cannot be disabled. You attempted to disable the only video terminal address on an 
ICS line or attempted to change its type to PRT (printer). (ICS displays this message at 
your terminal). 

COMMUNICATIONS LINE NAME REQUIRED: 

You invoked an SCI command procedure that requires a response to the 
COMMUNICATIONS LINE NAME prompt, but you responded with a null value. 
Reexecute the command specifying the desired communications line name. (ICS dis- 
plays this message at your terminal.) 

COMMUNICATIONS LINE xx ALREADY ACTIVE: 

You attempted to activate a communications line that is already active. The line is iden- 
tified by xx. You need activate each line only once after each initial program load (IPL). 
(ICS displays this message at your terminal.) 

COMMUNICATIONS LINE xx ACTIVATED: 

ICS displays this message to verify the successful activation of the ICS line identified 
by xx. This is not an error message. 

COMMUNICATIONS LINE DISCONNECTED FOR xx: 

ICS detected a hardware error at the communications line identified by xx. This error 
indicates the loss of the Data Set Ready signal. Ensure that the cable from the commu- 
nications line to the modem is properly connected. This error also can occur if the 
modem is in the loopback mode, so check the AL or DL switches on the modem. ICS 
writes this message to the system logging device, and if you have a transmission pend- 
ing, ICS displays this message at your terminal. 

CONTROL UNIT ADDRESS FOR xx MODIFIED FROM yy TOzz: 

ICS You have successfully modified the control unit address for the ICS line identified 
by xx from the value identified by yy to the new value identified by zz. (ICS displays this 
message at your terminal.) 
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CONTROL UNIT ADDRESS REQUIRED: 

ICS You have changed the Modify Control Unit Address (MCUA) command procedure. 
You must enter a new value for the control unit address. Each installed ICS communica- 
tions line must have a valid control unit address assigned to it. (ICS displays this mes- 
sage at your terminal.) 

DATA CONVERSION ERROR: 

ICS detected an error while attempting to convert either a character code to a binary 
value or a binary value into a character code. This is an internal error that you should 
report to your customer representative. 

ERROR xx IN ACCESS TO PARAMETER yy: 

ICS detected an SCI error. The parameter yy is a user-entered pathname or device name 
and is usually a communications line name. Check to see if the device specified is 
installed on the operating system. Error xx is an SCI error. The DX10 Error Reporting and 
Recovery Manual details SCI error codes. (ICS displays this message at your 
terminal.) 

ERROR xxyy DURING ICS ACTIVATION: 

ICS cannot successfully bid a user-written Program Station Control (PSC) task, or the 
Intertask communication (ITC) if the channel area is full. The parameter xx is the SVC 
opcode; yy is the SVC error code. The DX10 Error Reporting and Recovery Manual 
details SVC error codes. To correct this error condition, purge the ITC channel area. If 
this error persists, enlarge the ITC channel area. ICS writes this message to the system 
log.) 

HIGHEST TERMINAL ADDRESS IS xx: 

You specified a terminal address that exceeds the highest terminal address reserved for 
the ICS line during installation. The List Interactive Communications Configuration 
(LICC) command provides a list of installed terminal addresses. Choose one that is 
listed as enabled, ensuring that the type is correct. (ICS displays this message at your 
terminal.) 

HOST NOT POLLING COMMUNICATIONS LINE xx: 

ICS displays this message at your terminal when it detects no polling activity on the 
communications link for one minute. The absence of this message does not mean that 
the particular control unit address associated with ICS is being polled. Usually, when 
this message appears, the host is inoperative. The ICS line is identified by xx. Remem- 
ber that the host identifies ICS by its EBCDIC control unit address. The List Interactive 
Communications Configuration (LICC) command shows the decimal value of the control 
unit address assigned to an ICS line. Table 2-1 lists the EBCDIC value equivalent to the 
ICS decimal value. The systems programmer can use the Execute Poll Analyzer (XPA) 
command to verify this problem. If this message occurs frequently, you may need to 
increase the poll time-out parameter when you build the common communications DSR 
(using the BCD command). The DX10 Common Communications DSR Object Installa- 
tion document explains how to do this. 
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ICS NOT RUNNING AT xx: 

ICS displays this message at your terminal when you specify a terminal pathname 
(identified by xx) that is not assigned to an active or suspended ICS station. You cannot 
terminate an ICS station that is already inactive. Use the List Interactive Communica- 
tions Configuration (LICC) command to find out which ICS terminal addresses are 
active or suspended. LICC also lists any video stations that may be associated with 
those ICS terminal addresses. 

ICSPSC TERMINATED: 

ICS writes this message to the system logging device when the Programmed Station 
Control (PSC) interface to ICS has been terminated. This is an informative message, not 
necessarily an error. Your PSC program can terminate ICSPSC by issuing a Close call 
with the second argument (<a2>) specifying terminate. Issuing an Open call with the 
second argument (< a2>) specifying activate reactivates ICSPSC. 

INTERNAL ERROR: 

Miscellaneous data structures have incorrect values. ICS cannot translate the data from 
the host. Report this error to your systems programmer. 

INTERNAL ERROR, TIMEOUT FOR xx: 

ICS writes this message to the system logging device when it detects that a read buffer 
had no activity for five minutes. The controller task assigns read buffers to its stations 
from a common pool. When an ICS station holds one of these buffers for longer than 
five minutes and does not return it to the pool, this time-out occurs. The device asso- 
ciated with the ICS station that is assigned the inactive buffer is identified by xx (for 
example, ST02). The ICS station that has control of such a buffer is terminated. Consult 
your systems programmer if this occurs. 

INTERNAL ERROR, UNDEFINED TERMINAL STATE FOR xx: 

ICS writes this message to the system logging device when ICS attempts to access a 
terminal address whose state cannot be determined. The terminal address is identified 
by xx. This is a fatal error. The ICS video terminal task that owns this terminal address 
should be terminated and reactivated. Consult your systems programmer. 

INTERNAL ERROR, INVALID DEVICE ADDRESS FOR yy: 

ICS detected an internal controller error. The device (terminal) address identified by yy is 
invalid. Consult your systems programmer. (ICS writes this message to the system 
logging device.) 

INTERNAL ERROR, xx READ QUEUE: 

ICS writes this message to the system logging device when ICS detects an internal 
controller task error. The ICS communications line where the error occurred is identified 
by xx. One possible cause of this error is when ICS can no longer access an internal 
buffer. When this error occurs, the ICS controller task terminates. Consult your systems 
programmer. 
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INTERNAL ERROR ww, WP:xx, PC:yy, ST:zz: 

ICS writes this message to your terminal when it detects an internal task error identified 
by ww. The xx after WP indicates the value of the workspace pointer when ICS detected 
the error. The yy after PC indicates the program counter contents, and the zz after ST 
indicates the value of the status register when ICS detected the error. Consult your 
customer representative. 

INVALID CONTROL UNIT ADDRESS xx: 

You entered a value (identified by xx) that is not in the range of to 31 in response to the 
CONTROL UNIT ADDRESS prompt. Reexecute the Modify Control Unit Address (MCUA) 
command specifying a control unit address in the range of through 31. You can 
confirm the results of this operation by using the List Interactive Communications 
Configuration (LICC) command. (ICS displays this message at your terminal.) 

INVALID DATA RECEIVED: 

The host application sent a code that ICS does not support. This is not necessarily a 
fatal error. Some applications may service different types of 3270 stations and 
emulators for which these codes can have special meaning. Report these errors to your 
systems programmer. (ICS writes this message to the systems logging device and 
displays it at your terminal.) 

INVALID ICS PROTOCOL FOR xx: 

You responded to the COMMUNICATIONS LINE NAME prompt with a value that does 
not identify a valid ICS line. The value that you entered is identified by xx. This release of 
ICS supports only the Binary Synchronous Communications (BSC) procedures that the 
IBM 3271 Model 2 Control Unit uses. Consult your customer representative. (ICS 
displays this message at your terminal.) 

INVALID ICS TASK NAME: xx: 

ICS displays this message at your terminal if an ICS command procedure has been 
incorrectly modified. The task name sent as a parameter of a .BID primitive statement is 
identified by xx. Your systems programmer should correct the error in the command 
procedure. 

INVALID LOCAL FORMAT: zz: 

The ICSPSC task encountered an error while accessing the local format file. If you 
delete the local format file and start over, this error should not reoccur. The pathname of 
the local format file (represented by zz) is of the general form CMxxTMyy under the 
directory .S$ICS (where xx represents the decimal control unit address of the ICS line, 
and yy represents the terminal address.) If this error persists, contact your customer 
representative. (ICS writes this message to your terminal or the system logging device.) 

INVALID PRINTER PATHNAME xx: 

The value you entered in response to the OUTPUT PATHNAME prompt is invalid. This 
value is identified by xx and must be a valid pathname or a device name of an installed 
sequential output device (other than a communications controller). (ICS displays this 
message at your terminal.) 
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INVALID PRINT KEY PATHNAME xx: 

ICS displays this message at your terminal when you have specified an invalid 
pathname in response to the PRINT KEY PATHNAME prompt and you press the PRINT 
key. ICS writes this message to the system logging device when an invalid pathname is 
assigned to the PRINT key pathname and your PSC program generates the print code. 
Reactivate the display station and enter a valid pathname, or use the identification 
function. If your PSC program reports this error, you must activate the terminal address 
used by your program, specify a valid PRINT key pathname, then terminate the station 
before reexecuting your PSC program. 

INVALID PROGRAM FILE PATHNAME: xx: 

ICS cannot access the program file pathname identified by xx. This is the value you 
specified during the Execute ICS Programmed Station Control Task (XPSC) command. 
Make sure that you enter a valid DX10 pathname for the program file containing your 
PSC task. You can determine whether the value entered is a valid program file pathname 
by using the Map Program File (MPF) command. (ICS displays this message at your 
terminal.) 

INVALID PSC USER TASK NAME: xx: 

ICS displays this message at your terminal when the task name you enter in response to 
the TASK NAME prompt is not found in the program file specified. Make sure that the 
program file name specified is the desired program file, and check to see if the specified 
task name is in that program file. You can verify this with the Map Program File (MPF) 
command. 

INVALID TERMINAL ADDRESS: xx: 

ICS displays this message at your terminal when your response to the TERMINAL 
ADDRESS(0-31) prompt is not a decimal value in the range of to 31. The value you 
enter is identified by xx. Reexecute the command and specify a valid terminal address, 
or let ICS select one for you that is, (enter a null value). 

INVALID TERMINAL STATE xx: 

ICS displays this message at your terminal when you enter an invalid modifiable 
terminal state. When modifying the state of a terminal address using the Modify 
Interactive Communications Configuration (MICC) command, the only valid responses 
to the STATE prompt are ENABLED and DISABLED. Reexecute the command specifying 
one of these states. 

INVALID TERMINAL TYPE xx: 

ICS displays this message at your terminal when you enter an invalid terminal type in 
response to the TERMINAL TYPE(CRT/PRT) prompt. The value identified by xx is the 
value you entered. Retry, specifying CRT (video) or PRT (printer). 

NO TASK MEMORY FOUND AT > xxxx: 

The Execute Poll Analyzer (XPA) command procedure does not match your 
configuration. Each time you reinstall ICS, you must also generate the XPA command 
procedure. The DX10 3270 ICS Object Installation document describes how to do this. 
The 990 memory location, identified by xxxx, is where the current XPA command 
procedure searches for the ICS task area. 
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ONLY VALID FOR A VIDEO TERMINAL: 

ICS displays this message at your terminal when your response to the TERMINAL 
PATHNAME prompt is not a supported ICS video terminal. Use a device name of a video 
terminal that ICS supports and reexecute the command. 

PSC USER PROGRAM FILE ACNM REQUIRED: 

ICS displays this message at your terminal when you enter a null value in response to 
the USER PROGRAM FILE prompt and the Execute ICS Programmed Station Control 
Task (XPSC) command procedure has been modified. You must enter the program file 
pathname where your PSC program is located. If you do not know the correct program 
file pathname, consult your systems programmer. 

SVC ERR: xx, OP: yy: 

ICS encountered an SVC error identified by xx. Look up this value in the DX10 Error 
Reporting and Recovery Manual. The SVC operation code is identified by yy. 

SVC ERR: xx, OP: yy, PN : zz: 

ICS encountered an I/O SVC error identified by xx. If the value identified by zz is a 
communications line name, you should first consult the device service routine (DSR) 
internal error codes listed in Table B-1 . If Table B-1 does not list the value identified by 
xx, consult the installation and operation manual appropriate for the communications 
controller that the ICS line uses. These manuals are listed in paragraph A.3. If one of 
these manuals does not list the returned code, look it up in the DX10 Error Reporting and 
Recovery Manual. The SVC operation code is identified by yy. The value zz identifies the 
pathname or access name of the device that was being accessed by the supervisor call 
(SVC) block. This is an internal error that you should report to your customer 
representative. 

TASK AND DSR INCONSISTENT FOR xx: COMPLETE SYSGEN: 

ICS detected an inconsistency in the tables generated during installation. Make sure 
that you successfully generated and loaded the operating system with ICS declared. 
Also, make sure that ICS and the communications device service routine (DSR) are 
properly generated and installed. Ensure that you respond with the same value for the 
HIGHEST TERMINAL ADDR(0-31) prompt when installing ICS and the DX10 
communications DSR. Refer to the DX10 3270 ICS Object Installation document and the 
DX10 Common Communications DSR Object Installation document for complete 
instructions. 

TASK ERROR ww, WP: xx, PC: yy, ST: zz: 

This internal error is identified by ww and generated by the ICS video station task. The 
value represented by xx is the workspace pointer, yy is the program counter, and zz is 
the status register. You should report this error to your customer representative. 
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TERMINAL ADDRESS OR TYPE REQUIRED: 

When activating a user-written Programmed Station Control (PSC) task, you must 
specify either the terminal address or the terminal type that your program requires. If 
you do not specify the terminal address, ICS selects one for you, provided that you 
specify the type of terminal address (PRT or CRT). If you specify a particular terminal 
address, ICS does not check that the type of the specified address is correct. If your 
PSC program uses auto-select, do not specify a particular terminal address; specify 
only the type. If your PSC program uses a particular terminal address, use that terminal 
address when activating your program. ICS displays this message at the terminal at 
which you enter the XPSC command. 

TERMINAL ADDRESS NEEDED: 

A single physical device has more than one terminal address assigned to it, and you did 
not provide the terminal address when terminating the ICS station. To terminate both 
ICS stations at a single physical device, you must execute the Quit Interactive 
Communications Terminal (QICT) command twice. The first termination requires that 
the terminal address be specified. The terminal pathname is not required. After you 
terminate the first terminal address, the second execution of QICT does not require that 
you specify the terminal address. When only one terminal address is assigned to a 
single physical device serving as an ICS station, you can designate either the terminal 
pathname or the terminal address when terminating ICS. (ICS displays this message at 
your terminal.) 

TERMINAL PATHNAME OR ADDRESS MUST BE ENTERED: 

When terminating an ICS station, you must specify either the terminal address or the 
terminal pathname assigned to that address. Either one of these values identifies a 
specific ICS station except when one physical device has more than one terminal 
address assigned to it. (ICS displays this message at the terminal at which you enter the 
Quit Interactive Communications Terminal (QICT) command. 

TERMINAL ADDRESS xx BELONGS TO A PRINTER: 

ICS You attempted to use a terminal address that is reserved for a printer, but a video 
terminal address is required. You can use the List Interactive Communications 
Configuration (LICC) command to get a list of all the installed addresses and their type 
(CRT or PRT). Reselect a terminal address of the CRT type that is idle, or enter a null 
value and let ICS select one. (ICS displays this message at your terminal.) 

TERMINAL ADDRESS xx BELONGS TO A VIDEO TERMINAL: 

ICS displays this message at your terminal when the terminal address you specify 
during an ICS printer station activation is the CRT (video) type. Either select another 
address or let ICS select the address by entering a null value in response to the 
TERMINAL ADDRESS(0-31) prompt. The List Interactive Communications 
Configuration (LICC) command returns a list of the terminal addresses, their states, and 
types. If all video terminal addresses are in use, you must wait until one is terminated. 
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TERMINAL ADDRESS xx IS BUSY: 

The terminal address you specified is already in use by another user. The requested 
address is identified by xx. Choose another terminal address or let ICS choose one for 
you when you activate an ICS station. ICS automatically selects an idle terminal 
address of the correct type when you enter a null value in response to the TERMINAL 
ADDRESS(0 - 31) prompt. If you are attempting to modify the type or state of a terminal 
address by using the Modify Interactive Communications Configuration (MICC) 
command, you must first terminate the ICS station. You cannot modify a terminal 
address that is in an active, suspended, active PSC, or waiting PSC state. (ICS displays 
this message at your terminal.) 

TERMINAL ADDRESS xx ON COMMUNICATIONS LINE yy ACTIVATED: 

ICS writes this message to the system logging device to record that an ICS station has 
been successfully activated. The value xx represents the terminal address that is 
activated, and yy indicates the ICS communications line to which the terminal address 
belongs. 

TERMINAL ADDRESS xx NOT IN USE: 

ICS displays this message at your terminal when the terminal address you enter 
(represented by xx) is not in an active or suspended state. You cannot terminate an ICS 
station that is inactive. The List Interactive Communications Configuration (LICC) 
command provides a listing of the states of each terminal address reserved for a 
particular ICS communications line. LICC shows the state of an inactive terminal 
address as either IDLE or DISABLED. 

TERMINATED BY ANOTHER USER: 

ICS displays this message at your terminal when another user terminates your ICS 
station (identified by xx) by using the Quit Interactive Communications Terminal (QICT) 
command. This message indicates a normal termination. 

UNABLE TO TERMINATE ICS TASK, RUN ID xx: 

The value xx represents the task run ID of the ICS task that could not be terminated. You 
should retry the termination since there may be a transmission pending. When the 
pending transmission is complete, you can successfully perform the termination. This 
is an internal ICS task error. If it persists, report it to your customer representative. 

WARNING: DATA BUFFER HAS BEEN WRITTEN OVER BY NEW DATA: 

ICS writes this message to the system logging device to inform you that the station 
buffer belonging to a user-written Programmed Station Control (PSC) task has received 
new data from the host. Any data put into the station buffer that has not been 
transmitted is lost. Refill the station buffer before transmitting. You can avoid this error 
by specifying transmit as the action to follow a Get or Fill call. To do this, put a one in 
the sixth argument (< a6> ). Paragraph 5.3 describes the PSC routines. 
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The following messages are alphabetized according to their second elements since their first 
elements are variants: 

xx HAS NOT BEEN ACTIVATED BY "XICC": 

ICS displays this message at your terminal when the ICS communications line 
identified by xx has not been activated. To activate an ICS station, you must first 
activate the ICS line. Activate the line by using the Execute Interactive Communications 
Controller (XICC) command before retrying the station activation. 

xx IS NOT AN ICS COMMUNICATIONS LINE: 

ICS displays this message at your terminal when your response to the 
COMMUNICATIONS LINE NAME prompt is not a valid ICS communications line. The 
value you enter is identified by xx. Reenter the SCI command, specifying a valid ICS 
communications line. 



B.3 DEVICE SERVICE ROUTINE (DSR) ERROR CODES 

Table B-1 lists the internal DSR error codes that ICS returns in some messages as SVC errors. 
If the error you received is not in this list, consult the appropriate hardware reference manual, as 
follows: 

• Bit-Oriented/Character-Oriented/Asynchronous Interface Module Installation and Oper- 
ation Manual 

• Four-Channel Communications Controller Installation and Operation Manual 

The Communications Interface Module (CIM) and the Two-Channel Communications Interface 
Module do not return error codes to the communications DSR. If your ICS line uses a CIM as its 
communications controller, you do not need to reference the CIM hardware manual. 

If the SVC error that ICS returned is not listed in either Table B-1 or the BCAIM or FCCC hardware 
manual, look up the SVC error in the DX10 Error Reporting and Recovery Manual. 
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Table B-1. 3270 DSR Error Codes 



Hexadecimal Code Description 



02 Illegal operation. Contact your customer representative 

03 Device in use. The DSR returns this error code when the ICS station task has 
specified a station that is already active when a second ICS controller task is bid 
on a communications controller channel whose memory has been purged. 

06 I/O aborted. The DSR returns this error when the I/O in progress is aborted. 

07 Device error. The DSR has detected a hardware error. 

18 Line Disconnected. 

26 Read Only Memory (ROM) code not correct for specified patch file. You do not 

have the required firmware installed on the ICS communications controller. The 
revision level of your FCCC should be revision P or later. The version level of your 
BCAIM should be A or later. 

43 Write parameters not legal with I/O in progress. Write parameters have been 
specified by the MICA task while an I/O was in progress. 

44 Invalid ICS protocol. The wrong character detect routine resides in the memory 
of the communications controller. 

5E An illegal station. The ICS station task has specified an illegal station during an 

open, write, or close. The ICS and DSR parameters are not consistent. Ensure 
you have correctly installed and generated the ICS tasks and the communica- 
tions DSR. 

72 Extended flags not specified. Either the controller task did not specify the con- 

troller ID and number of stations during an open, or a station task did not specify 
the station during an open, write, or close. 



B.4 PSC ERROR CODES AND DESCRIPTIONS 

The following list describes the error codes reported to a user-written program making use of the 
capability to emulate an ICS station. If an error is detected when you activate a PSC program by 
using the Execute ICS Programmed Station Control Task (XPSC) command, the error is returned to 
the station at which you entered the command. These messages are listed along with the other 
ICS messages in paragraph B.2. 
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Error Code Description 

0001 ICS station already open. A PSC task attempted to open an ICS station 
already opened by another ICS task. 

0002 Illegal number of arguments in a call statement. Some PSC routines generate 
this error code when too few or too many arguments are specified by the call 
statement. Count the arguments specified in the call statement and either 
add the missing argument or delete the extra one. 

0003 Invalid field or subfield. Compare the fourth and fifth arguments (< a4> and 
< a5>) of the most recent Fill or Get call with the format of the screen buffer 
to ensure that the fill or get operation begins within a field on the screen. 

0004 Invalid control unit or station address. The first argument (<a1>) of some call 
statement is not in the range of valid values. This usually occurs with the 
Open call statement. Reference the Open call statement description and 
Table 2-1 for the valid values for the IBM control unit and terminal addresses. 

0005 ICS station already active (ready). The terminal address specified in your 
Open call is already in use (active). Either your program has already activated 
the PSC Emulator, or someone else is already using the requested address. 
Ensure that your program specified the correct control unit address. 

0006 Control unit or terminal address not found. The control unit or terminal 
address specified in the Open call statement has not been reserved during 
ICS installation. The List Interactive Communications Configuration (LICC) 
command displays the available addresses for each ICS line. 

0007 ICS station not active. The terminal address specified in any call statement, 
except the Open, is that of a station that has not been opened with an Open 
call statement. Ensure that your program specified the correct control unit 
address. 

0008 Reserved. 

0009 Invalid function key code in a Transmit call statement. The value specified by 
the second argument (< a2> ) of the Transmit call statement is not a valid pro- 
gram attention key code. See Table 5-1 for the list of supported attention ID 
(AID) codes. 

000A Invalid character in a fill buffer. See that the buffer specified as the second 

argument (<a2>) for the Fill routine contains only valid seven-bit ASCII 
characters. 

000B Attempt to call a PSC routine before the previous transmission has been pro- 

cessed by the host. Call the time-out routine after each call to the Get or Fill 
routine that transmits or clears the station buffer and after every call to the 
Transmit routine. If the error persists, call the Transmit routine specifying the 
reset attention ID (AID) code (17). 
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Error Code Description 

000C Invalid operation for ICS printer station. The value specified for the first argu- 

ment (< a1 > ) of the Open routine indicates that the PSC program is serving as 
a printer station, but the host transmitted a command with orders appropriate 
for a display station. Either change the value of the high-order byte of the 
word containing the terminal address or use a PSC printer station program to 
respond to the host application. 

000D No new data available. There is no data available for the PSC Transmit or Get 

routine called, so the PSC Emulator returns this informative message to indi- 
cate that no data was retrieved or transmitted. 

000E Host computer not polling (only on Transmit routine call statement). Ninety 

seconds have elapsed without a general or specific poll from the host. Your 
program should return this message to some logging device so that corrective 
action can be taken when necessary. 

000F Host not polling. 

0010 ICS system error. This problem may be caused by no response from the 
communications hardware. If the error persists, contact your customer 
representative. 

0011 Reserved. 

0012 Communications hardware error (only on Transmit and Open call statements). 
A hardware error occurred in the communications equipment. 

0013 Misuse of channel (detected by ICS station). The ICS task detected a bad task 
ID in a data read (system error). 

0014 Invalid option specified. The value of the second argument (<a2>) of an 
Open, Close, or Transmit call statement or the sixth argument (<a6>)of a Fill 
or Get call statement is not supported. See paragraph 5.3 for the valid values. 

0015 Invalid address (odd address). The buffer defined by the second argument 
(<a2>) in a Fill or Get call statement does not start on an even address 
boundary. Check your data structures to ensure that the buffer begins on a 
word boundary (even address). If using 990 assembly language, an EVEN 
statement prior to the second argument (<a2>) data block ensures a word 
boundary. 

0016 Accessed field protected on Fill call statement. The fourth and fifth argu- 
ments (< a4> and < a5> ) of the Fill statement specify a protected field. Check 
the attribute byte for protection before attempting to modify the field. 

0017 Reserved. 

0018 Terminal address not active. A PSC task has referenced an ICS terminal 
address that is no longer active. Check the system log for error messages. 
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Error Code Description 

0019 Invalid data length. Correct the length argument that indicates a field length 
that is negative, zero, or greater than 1920. 

001A Station not open. Make sure the PSC program calls the Open routine before it 

calls any other routines. 

001 B Port/Controller conflict. Bits six and seven of the first byte of the first word of 

the first argument (<a1>) in the Open call statement are both one. This is a 
conflict because bit six specifies auto-select a control unit address and bit 
seven specifies that PSC uses a communications device name. Use one or the 
other, but not both. 

001 C Reserved. 

001 D Device not available. The terminal address specified in the first argument 

(<a1>) of the Open call statement is either in use, disabled, or not reserved. 
To avoid this, use either auto-select or a terminal address that you are sure no 
one else is using. 

001 E Emulator execution error. This is an internal error that should occur only if 

someone has modified the ICSPSC task. If this error occurs, report it to your 
customer representative. 

001 F Program file error. This is an internal error that should occur only if someone 

has modified the ICSPSC task. It indicates that the start-up task is unable 
to successfully assign a logical unit number (LUNO) to the program file 
containing the ICSPSC task. If this error occurs, report it to your customer 
representative. 

0020 Activate option error. This occurs if your program specifies do not activate 
when PSC is not active or if your program specifies activate when PSC is 
already active. 

00FF Station not responding (system error). ICSPSC has terminated abnormally. 

Check the system logging device to determine the cause of this termination. 
Consult your systems programmer. 

The DX10 Error Reporting and Recovery Manual, Volume VI, describes other error codes that may 
be encountered. 
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Appendix C 
ICS Hardware Requirements 



C.1 INTRODUCTION 

ICS runs with the DX10 standard equipment configuration. A Model 990/10, 990/12, or Business 
System 300 (or larger) Computer is required with the following minimum equipment: 

• 1 28K words (256K bytes) of memory 

• A system disk 

• A system console that can be either a video display terminal or an automatic 
send/receive data terminal 

• A means of disk backup 

• One of the communications interface sets listed in Table C-3 (for Tl modems) or Table 
C-4 (for non-TI modems) 



C.2 MEMORY REQUIREMENTS 

ICS uses more memory space when its lines and terminals are active than when inactive. The 
static memory requirements refer to the memory that ICS requires when it is inactive. The dynamic 
memory requirements refer to the memory that ICS uses when it is active. 

The static memory requirements for ICS depend on the installed configuration. The following 
three considerations affect the total memory size of ICS: 

• Receive buffer size for each ICS line 

• Number of ICS lines installed 

• Number of terminal addresses on each line 

Since ICS shares a number of its tasks, you cannot determine the memory requirements by simple 
addition. Installations with two ICS lines do not require twice as much memory as those with only 
one ICS line. You can determine the approximate memory size of ICS by using the information in 
the following paragraphs. 

The memory size of ICS for an installation with only one ICS line having only one reserved terminal 
address depends on the size specified for the receive buffer. The DX10 3270 ICS Object Installa- 
tion explains how the size of the receive buffer is determined. Table C-1 lists the amount of mem- 
ory allocated for each declared buffer size. 
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Table C-1. Allocated Memory for Each Buffer Size 



Declared Buffer Size 
(in Bytes) 


Allocated Memory 
(in Bytes) 


3,840 


4,170 


5,120 


5,580 


5,440 


5,900 


5,760 


6,220 


6,080 


6,540 


6,400 


6,860 



Each additional terminal address (beyond one) reserved during installation requires 64 bytes of 
additional memory. So the static memory requirements for an ICS installation with only one line 
having a receive buffer size of X and Y number of terminal addresses can be computed as follows: 

520 + 68 + (YX1) + X 

For each additional installed ICS line, 68 additional bytes of memory are required plus the memory 
required for the receive buffer and terminal addresses for the additional line. The general form for 
this calculation is as follows: 

520+ (# of lines x 68)+ (#of terminal addresses x 64) + total receive buffer size 

To determine the total static memory requirements for your particular installation, calculate the 
size of each line and add them up. 

When you activate an ICS line, ICS uses more memory. You can determine the dynamic memory 
requirements for ICS by referring to Table C-2. If you activate one ICS line, the amount of memory 
that the operating system allocates is equal to the nonreplicatable requirements plus the replicat- 
able requirements. When you activate a second ICS line, the operating system allocates only the 
replicatable requirement. The same is true for video stations, printers stations, and Programmed 
Station Control (PSC) emulators. For example, when you activate an ICS line, the operating sys- 
tem allocates 7,800 plus 4,200 bytes of memory for a total of 15,000 bytes. When you activate a 
second ICS line, the operating system allocates only an additional 4,200 bytes for a total of 12,200 
bytes. All the figures in Table C-2 are rounded up to the nearest hundred bytes. 
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Table C-2. Dynamic Memory Requirements for ICS Tasks 



ICS Task Nonreplicatable Replicatable 

Controller 7,800 4,200 

(communications line) 

Video station 21,300 8,500 

Printer station 13,300 6,200 

PSC Emulator 17,500 7,200 



C.3 SUPPORTED HARDWARE 

The supported non-TI modems are the Western Electric (Bell) modems (listed in Table C-5). The 
options recommended are listed with each modem. Table C-5 also lists those modem options 
required when the specified modem is used with ICS. The non-TI communications components 
(Table C-4) support the Western Electric (Bell) modems. Table C-3 lists the Tl modems and commu- 
nications interface kits that support ICS. 

In recent years, the telephone company has begun to offer facilities that are capable of transmit- 
ting digital information directly without converting it to analog. For digital service, a modem is not 
used, but a similar device called a data service unit (DSU) provides the interface between the 
communications controller and the communications line. Digital data service is generally used 
only for high-speed information exchange between computers and is not yet available in all areas. 

Digital lines offer a major advantage over conventional analog transmissions. Amplifiers placed 
approximately every mile along the line counteract signal degradation. In analog transmissions, 
noise and signal distortion are amplified. With digital transmissions, the signal is restored with- 
out any of the noise and distortion that may have occurred during transmission. 

For ICS transmissions across the Digital Data System (DDS), DSUs using the RS-232C interface at 
2,400, 4,800, or 9,600 bits per second are used instead of modems. Consult your Bell representa- 
tive to determine availability of the service, rates, and the specific DSU required. 
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Table C-3. Tl Communications Interface Kits 



Communications Interface 



Tl Modem (201 C Equivalent) 



CIMKit: 
946104-0001 

FCCC Kit: 
2261954-0001 



BCAIM Kit: 
2265184-0001 

X.21 BCAIM Kit: 
2303091-0001 



Synchronous Modem Kit: 
945094-0003 

Synchronous Modem Kit: 
945094-0003 
(one per channel) 

Synchronous Modem Kit: 
945094-0003 

Synchronous Modem Kit: 
945094-0003 



Notes: 

1 The revision level for the FCCC in this kit should be revision P or later. 

2 The revision level for the BCAIM controller in this kit should be revision A or later. 



Table C-4. Non-TI Communications Interface Components 



Communications Interface 



Non-TI Modem Components 



Communications Interface 
Module (CIM) Kit: 
946104-0002 

Four-Channel Communications 
Controller (FCCC) Kit: 
2261954-0001 

Two-Channel Communications 
Interface Module Kit: v 
253283-0001 or -0002 

Bit-Oriented, Character-oriented, 
Asynchronous Interface Module 
(BCAIM) Kit: 
2265184-0001 

X.21 Bit-Oriented, 
Character-oriented, 
Asynchronous Interface Module: 
2303091-0002 



The kit comprises: 
CIM— 946105-0001 
Cable — 946117-0001 

The FCCC requires: 
Cable — 946117-0001 or -0002 
(one per channel) 

The kit comprises: 
Cable — 2532883-0001,-0002, 
-0003, or -0004 

The kit comprises: 
BCAIM — 2265165-0001 
Cable — 2303070-0002 



The kit comprises: 

X.21 BCAIM — 2303085-0001 
Cable — 2303070-0002 



Notes: 

1 The revision level for the FCCC should be revision P or later. 

2 The revision level for the BCAIM should be revision A or later. 
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ICS Hardware Requirements 



Western Electric 
(Bell) Modem 



Recommended 
Options 



Required 
Options 



Model 201 B None 

leased-line 
operation 
2400 bps 

Model 201 C 
leased-line 
2400 bps 

Model 2024A 
DATAPHONEII 
leased-line 
operation, 2400 bps 

Model 208A 
leased-line 
operation, 
4800 bps 

Model 2048C 
DATAPHONEII* 
leased-line 
operation, 4800 bps 

Model 209A 
multiplexed 
leased-line 
operation, 2400, 
4800, 7200, 
or 9600 bps 

Model 2096A 
DATAPHONEII 
multiplexed 
leased-line 
operation, 2400, 
4800, or 9600 bps 

Note: 

* The C indicates quick start-up and is recommended for use with ICS lines. 



Grounding option 
(AB not connected 
toAA) 

None 



Grounding option 
(AB not connected 
toAA) 



None 



Grounding option 
(AB not connected 
toAA) 
Elastic store out 



None 



Without new sync 
EIA option 

Internal timing 

Without new sync 
Internal timing 
EIA option 

Internal timing 



Internal timing 



Internal timing 



Internal timing 



Internal timing 
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Appendix D 

ASCII/EBCDIC, EBCDIC/ASCII 

Translation Tables 



The IBM Binary Synchronous Communications (BSC) procedures employed by ICS require that all 
data be translated and transmitted as EBCDIC-encoded data. Those EBCDIC characters less than 
>40 for which ASCII has no equivalent are translated to null characters. Those EBCDIC charac- 
ters greater than or equal to >40 for which ASCII has no equivalent are translated to space 
characters. 

The tables included in this appendix contain the following information: 

• ASCII-to-EBCDIC translations; entire ASCII character set (Table D-1). 

• EBCDIC-to-ASCII translations; entire EBCDIC character set (Table D-2). 
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Table D-1 . ASCII-to-EBCDIC Translation 



ASCII 
VALUE 


ASCII 
CHAR 


EBCDIC 
VALUE 


EBCDIC 
CHAR 


00 


NUL 


00 


NUL 


01 


SOH 


01 


SOH 


02 


STX 


02 


STX 


03 


ETX 


03 


ETX 


04 


EOT 


37 


EOT 


05 


ENQ 


2D 


ENQ 


06 


ACK 


2E 


ACK 


07 


BEL 


2F 


BEL 


08 


BS 


16 


BS 


09 


HT 


05 


HT 


OA 


LF 


25 


LF 


OB 


VT 


OB 


VT 


OC 


FF 


OC 


FF 


OD 


CR 


OD 


CR 


OE 


SO 


OE 


SO 


OF 


SI 


OF 


SI 


10 


DLE 


10 


DLE 


1 1 


DC1 


1 1 


DC1 


12 


DC2 


12 


DC2 


13 


DC3 


13 


TM 


14 


DC4 


3C 


DC4 


15 


NAK 


3D 


NAK 


16 


SYN 


32 


SYN 


17 


ETB 


26 


ETB 


1 8 


CAN 


18 


CAN 


19 


EM 


19 


EM 


1A 


SUB 


3F 


SUB 


1 B 


ESC 


27 


ESC 


1C 


FS 


IC 


IFS 


1D 


GS 


ID 


IGS 


IE 


RS 


IE 


IRS 


IF 


US 


IF 


IUS 



ASCII 
VALUE 


ASCII 

CHAR 


EBCDIC 
VALUE 


EBCDIC 
CHAR 


20 


SPACE 


40 


SPACE 


21 


! 


5A 


! 


22 


» 


7F 


»> 


23 


# 


7B 


# 


24 


$ 


5B 


* 


25 


% 


6C 


% 


26 


& 


50 


& 


27 


t 


7D 


9 


28 


( 


4D 


( 


29 


) 


5D 


) 


2A 


* 


5C 


* 


2B 


+ 


4E 


+ 


2C 


1 


6B 


» 


2D 


- 


60 


- 


2E 


. 


4B 


. 


2F 


/ 


61 


/ 


30 





FO 





31 


1 


F1 


1 


32 


2 


F2 


2 


33 


3 


F3 


3 


34 


4 


F4 


4 


35 


5 


F5 


5 


36 


6 


F6 


6 


37 


7 


F7 


7 


38 


8 


F8 


8 


39 


9 


F9 


9 


3A 


• 


7A 


• 


3B 


> 


5E 


> 


3C 


< 


4C 


< 


3D 


= 


7E 


= 


3E 


> 


6E 


> 


3F 


? 


6F 


? 
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Table D-1 . ASCII-to-EBCDIC Translation (Continued) 



ASCII 
VALUE 


ASCII 
CHAR 


EBCDIC 
VALUE 


EBCDIC, 
CHAR 


40 


@ 


7C 


@ 


41 


A 


C1 


A 


42 


B 


C2 


B 


43 


C 


C3 


C 


44 


D 


C4 


D 


45 


E 


C5 


E 


46 


F 


C6 


F 


47 


G 


C7 


G 


48 


H 


C8 


H 


49 


I 


C9 


I 


4A 


J 


D1 


J 


4B 


K 


D2 


K 


4C 


L 


D3 


L 


4D 


M 


D4 


M 


4E 


N 


D5 


N 


4F 


O 


D6 





50 


P 


D7 


P 


51 


Q 


D8 


Q 


52 


R 


D9 


R 


53 


S 


E2 


S 


54 


T 


E3 


T 


55 


U 


E4 


U 


56 


V 


E5 


V 


57 


w 


E6 


w 


58 


X 


E7 


X 


59 


Y 


E8 


Y 


5A 


z 


E9 


z 


5B 


C 


4A 


$ 


5C 


\ 


E0 


\ 


5D 


] 


4F 


1 


5E 


A 


5F 


—7 


5F 


— 


6D 


- 



ASCII 
VALUE 



60 

61 

62 

63 

64 

65 

66 

67 

68 

69 

6A 

6B 

6C 

6D 

6E 

6F 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

7A 

7B 

7C 

7D 

7E 

7F 



ASCII 
CHAR 



EBCDIC 
VALUE 



m 
n 
o 

P 

q 

r 
s 

t 
u 

V 

w 

X 

y 

z 



DEL 



79 

81 

82 

83 

84 

85 

86 

87 

88 

89 

91 

92 

93 

94 

95 

96 

97 

98 

99 

A2 

A3 

A4 

A5 

A6 

A7 

A8 

A9 

CO 

4F 

DO 

A1 

07 



EBCDIC 
CHAR 



a 
b 
c 
d 
e 
f 

g 

h 
i 

J 

k 
I 

m 
n 
o 
P 

q 

r 
s 
t 
u 

V 

w 

X 

y 

z 



DEL 
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Table D-2. EBCDIC-to-ASCII Translation 



EBCDIC 
VALUE 


EBCDIC 
CHAR 


ASCII 
VALUE 


ASCII 
CHAR 


00 


NUL 


00 


NUL 


01 


SOH 


01 


SOH 


02 


STX 


02 


STX 


03 


ETX 


03 


ETX 


04 


PF 


00 


NUL 


05 


HT 


09 


HT 


06 


I_C 


00 


NUL 


07 


DEL 


7F 


DEL 


08 




00 


NUL 


09 


RLF 


00 


NUL 


OA 


SMM 


00 


NUL 


OB 


VT 


OB 


VT 


OC 


FF 


OC 


FF 


OD 


CR 


OD 


CR 


OE 


SO 


OE 


SO 


OF 


SI 


OF 


SI 


10 


DLE 


10 


DLE 


1 1 


DC1 


1 1 


DC1 


12 


DC2 


12 


DC2 


13 


DC3 


13 


DC3 


14 


RES 


00 


NUL 


15 


NL 


15 


NAK 


16 ' 


BS 


08 


BS 


17 


IL 


00 


NUL 


18 


CAN 


1 8 


CAN 


19 


EM 


19 


EM 


1 A 


CC 


00 


NUL 


IB 


CU1 


00 


NUL 


1C 


IFS 


IC 


FS 


ID 


IGS 


ID 


GS 


IE 


IRS 


IE 


RS 


IF 


IUS 


IF 


US 



EBCDIC 
VALUE 


EBCDIC 
CHAR 


ASCII 
VALUE 


ASCII 
CHAR 


20 


DS 


00 


NUL 


21 


SOS 


00 


NUL 


22 


FS 


00 


NUL 


23 




00 


NUL 


24 


BYP 


00 


NUL 


25 


LF 


OA 


LF 


26 


ETB 


1 7 


ETB 


27 


ESC 


00 


NUL 


28 




00 


NUL 


29 




00 


NUL 


2A 


SM 


00 


NUL 


2B 


CU2 


00 


NUL 


2C 




00 


NUL 


2D 


ENQ 


05 


ENQ 


2E 


ACK 


06 


ACK 


2F 


BEL 


07 


BEL 


30 




00 


NUL 


31 




00 


NUL 


32 


SYN 


16 


SYN 


33 




00 


NUL 


34 


PN 


00 


NUL 


35 


RS 


00 


NUL 


36 


UC 


00 


NUL 


37 


EOT 


04 


EOT 


38 




00 


NUL 


39 




00 


NUL 


3A 




00 


NUL 


3B 


CU3 


00 


NUL 


3C 


DC4 


1 4 


DC4 


3D 


NAK 


15 


NAK 


3E 




00 


NUL 


3F 


SUB 


1 A 


SUB 



EBCDIC 
VALUE 


EBCDIC 
CHAR 


ASCII 
VALUE 


ASCII 
CHAR 


40 


SPACE 


00 


NUL 


41 




00 


NUL 


42 




00 


NUL 


43 




00 


NUL 


44 




00 


NUL 


45 




00 


NUL 


46 




00 


NUL 


47 




00 


NUL 


48 




00 


NUL 


49 




00 


NUL 


4A 


C 


5B 


c 


4B 




2E 




4C 


< 


3C 


< 


4D 


( 


28 


( 


4E 


+ 


2B 


+ 


4F 


1 


7C 


1 

1 


50 


& 


26 


& 


51 




00 


NUL 


52 




00 


NUL 


53 




00 


NUL 


54 




00 


NUL 


55 




00 


NUL 


56 




00 


NUL 


57 




00 


NUL 


38 




00 


NUL 


59 




00 


NUL 


5A 


! 


21 


! 


5B 


$ 


24 


$ 


5C 


* 


2A 


* 


5D 


) 


29 


) 


5E 


j 


3B 


» 


5F 


~~7 


5E 


A 
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Table D-2. EBCDIC-to-ASCII Translation (Continued) 



EBCDIC 
VALUE 


EBCDIC 
CHAR 


ASCII 
VALUE 


ASCII 
CHAR 


60 


- 


2D 


- 


61 


/ 


2F 




62 




00 


NUL 


63 




00 


NUL 


64 




00 


NUL 


65 




00 


NUL 


66 




00 


NUL 


67 




00 


NUL 


68 




00 


NUL 


69 




00 


NUL 


6A 


1 
1 


7C 


1 
1 


6B 


» 


2C 


, 


6C 


% 


25 


% 


6D 


- 


5F 


- 


6E 


> 


3E 


> 


6F 


? 


3F 


? 


70 




00 


NUL 


71 




00 


NUL 


72 




00 


NUL 


73 




00 


NUL 


74 




00 


NUL 


75 




00 


NUL 


76 




00 


NUL 


77 




00 


NUL 


78 




00 


NUL 


79 


\ 


60 


\ 


7A 


• 


3A 


1 


7B 


# 


23 


# 


7C 


@ 


40 


@ 


7D 


> 


27 


f 


7E 


s 


3D 


= 


7F 


» 


22 


» 



EBCDIC 
VALUE 


EBCDIC 
CHAR 


ASCII 
VALUE 


ASCII 
CHAR 


80 




00 


NUL 


81 


a 


61 


a 


82 


t) 


62 


b 


83 


c 


63 


c 


84 


d 


64 


d 


85 


e 


65 


e 


86 


f 


66 


f 


87 


g 


67 


g 


88 


h 


68 


h 


89 


i 


69 


i 


8A 




00 


NUL 


8B 




00 


NUL 


8C 




00 


NUL 


8D 




00 


NUL 


8E 




00 


NUL 


8F 




00 


NUL 


90 




00 


NUL 


91 


i 


6A 


J 


92 


k 


6B 


k 


93 


1 


6C 


1 


94 


m 


6D 


m 


95 


n 


6E 


n 


96 


o 


6F 


o 


97 


P 


70 


P 


98 


<A 


71 


q 


99 


r 


72 


r 


9A 




00 


NUL 


9B 




00 


NUL 


9C 




00 


NUL 


9D 




00 


NUL 


9E 




00 


NUL 


9F 




00 


NUL 



EBCDIC 
VALUE 


EBCDIC 
CHAR 


ASCII 
VALUE 


ASCII 
CHAR 


A0 




00 


NUL 


A1 


-^ 


7E 


~ 


A2 


S 


73 


s 


A3 


t 


74 


t 


A4 


u 


75 


u 


A5 


V 


76 


V 


A6 


w 


77 


w 


A7 


X 


78 


X 


A8 


y 


79 


V 


A9 


I 


7A 


i 


AA 




00 


NUL 


AB 




00 


NUL 


AC 




00 


NUL 


AD 




00 


NUL 


AE 




00 


NUL 


AF 




00 


NUL 


B0 




00 


NUL 


B1 




00 


NUL 


B2 




00 


NUL 


B3 




00 


NUL 


B4 




00 


NUL 


B5 




00 


NUL 


B6 




00 


NUL 


B7 




00 


NUL 


B8 




00 


NUL 


B9 




00 


NUL 


BA 




00 


NUL 


BB 




00 


NUL 


BC 




00 


NUL 


BD 




00 


NUL 


BE 




00 


NUL 


BF 




00 


NUL 
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Table D-2. EBCDIC-to-ASCII Translation (Continued) 



EBCDIC 
VALUE 


EBCDIC 
CHAR 


ASCII 
VALUE 


ASCII 
CHAR 


CO 


i 


7B 


I 


CI 


A 


41 


A 


C2 


B 


42 


B 


C3 


C 


43 


C 


C4 


D 


44 


D 


C5 


E 


45 


"E 


C6 


F 


46 


F 


C7 


G 


47 


G 


C8 


H 


48 


H 


C9 


I 


49 


I 


CA 




00 


NUL 


CB 




00 


NUL 


CC 


J"" 


00 


NUL 


CD 




00 


NUL 


CE 


Y 


00 


NUL 


CF 




00 


NUL 


DO 


[ 


7D 


f 


D1 


j 


4A 


J 


D2 


K 


4B 


K 


D3 


L 


4C 


L 


D4 


M 


4D 


M 


D5 


N 


4E 


N 


D6 





4F 


O 


D7 


P 


50 


P 


D8 


Q 


51 


Q 


D9 


R 


52 


R 


DA 




00 


NUL 


DB 




00 


NUL 


DC 




00 


NUL 


DD 




00 


NUL 


DE 




00 


NUL 


DF 




00 


NUL 



EBCDIC 
VALUE 


EBCDIC 
CHAR 


ASCII 
VALUE 


ASCII 8 
CHAR 


EO 


\ 


5C 


\ 


E1 




00 


NUL 


E2 


S 


53 


S 


E3 


T 


54 


T 


E4 


U 


55 


U 


E5 


V 


56 


V 


E6 


w 


57 


w 


E7 


X 


58 


X 


E8 


Y 


59 


Y 


E9 


Z 


5A 


Z 


EA 




00 


NUL 


EB 




00 


NUL 


EC 


ri 


00 


NUL 


ED 




00 


NUL 


EE 




00 


NUL 


EF 




00 


NUL 


FO 





30 





F1 


1 


31 


1 


F2 


2 


32 


2 


F3 


3 


33 


3 


F4 


4 


34 


4 


F5 


5 


35 


5 


F6 


6 


36 


6 


F7 


7 


37 


7 


F8 


8 


38 


8 


F9 


9 


39 


9 


FA 




00 


NUL 
NUL 


FB 




00 


FC 




00 


NUL 


FD 




00 


NUL 


FE 




00 


NUL 


FF 




00 


NUL I 
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Appendix E 

Summary of ICS 
Commands and Key Functions 



This appendix provides a quick-reference summary of all the System Command Interpreter (SCI) 
command procedures used by ICS and the special key functions of ICS. Table E-1 lists the SCI 
procedures in alphabetical order along with the paragraphs that detail the operation of the 
command. The key functions are listed twice. Table E-2 is alphabetized according to the function 
description. Tables E-3 through E-5 are alphabetized according to the keys you enter. Table E-3 
lists the key mapping for the 911 and 915 terminals. Table E-4 lists the key mapping for the 940 
EVT, and Table E-5 lists the key mapping for the Business System terminal. Table E-6 lists the key 
mapping for the 931 VDT. 

For quick reference when using the DX10 operating system, ICS provides a menu that lists all 
these commands. To display this menu at a video terminal, enter the following characters in 
response to the SCI prompt: 

/ICS 



Table E-1. ICS SCI Commands 



Command 



Command Name 



Description 



LICC List Interactive 

Communications 
Configurations 

LICS List Interactive 

Communications 
Statistics 

MCUA Modify Control Unit 

Address 

MICC Modify Interactive 

Communications 
Configuration 

PTPSC Patch ICS PSC User 

Task 



QICT Quit Interactive 

Communications 
Terminal 



Displays the current installed configuration for a 
specific line. (See paragraph 4.3.1). 



Displays statistical information about an 
individual ICS line. (See paragraph 4.4.) 



Changes the control unit address of an inactive 
ICS line. (See paragraph 4.3.3.) 

Changes the state (enabled or disabled) and the 
type (CRT or PRT) of a particular terminal address. 
(See paragraph 4.3.2.) 

Applies the latest patches to the PSC Emulator 
routines linked to the user-written PSC task. (See 
paragraph 5.6.) 

Terminates a particular ICS display or printer 
station. (See paragraph 3.3.2.1.) 
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Summary of ICS Commands and Key Functions 



Table E-1. ICS SCI Commands (Continued) 



Command 



Command Name 



Description 



XICC Execute Interactive 

Communications 
Controller 

XICP Execute Interactive 

Communications 
Printer 

XICT Execute Interactive 

Communications 
Terminal 

XPA Execute Poll 

Analyzer 

XPSC Execute Programmed 

Station Control 



Activates an ICS communications line. (See 
paragraph 4.2.2.) 



Activates an ICS printer station. (See paragraph 
3.2.2.) 



Activates an ICS video station. (See paragraph 
3.2.1.) 



Provides a listing of ICS buffer activity for the 
systems analyst. (See paragraph 4.5.) 

Activates a user-written program that acts in 
place of an ICS station. (See paragraph 5.7.) 



Table E-2. Key Functions of ICS — Listed by Function 



Key Function 



Generic 

Key Sequence(s) 



Alpha (overrides numeric protection) 

Append cursor to the end of a word 

Clear screen 

Duplicate, remote (duplicate previous field) 

Duplicate, local (duplicate previous field) 

Erase to end-of-screen (EOS) 

Field mark (identifies the field as modified) 

Home cursor (cursor to the first character 
position) 

Identification function (identify or change 
the print key pathname) 



Exit + A 
Exit + P 

Initialize Input 1 
Exit + D 
Exit + L 
Exit + E 2 
Exit + F 
HOME 

Exit + 1 
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Summary of ICS Commands and Key Functions 



Table E-2. Key Functions of ICS — Listed by Function (Continued) 



Key Function 



Generic 

Key Sequence(s) 



Print screen 

Print screen cancel 

Program access key one, PA1 

Program access key two, PA2 

Program access key three, PA3 

Program function keys, PF1 through PF24 

Repeat (extension of the typamatic feature) 

Reset (unlock keyboard) 
Suspend ICS station 
Tab mode toggle (TABS and WORD) 
Terminate ICS station 

Notes: 

1 940 EVT key sequence: ERASE ALL 

2 940 EVT key sequence: ERASE EOS 

3 940 EVT key sequence: (ALT)P1 

4 940 EVT key sequence: (ALT)P2 

5 940 EVT key sequence: (ALT)P3 

6 940 EVT key sequence: F1 through F24 

7 91 1 and 915 have REPEAT keys 

8 940 EVT key sequence: (ALT) '(Control 9) 



PRINT 

PRINT+ PRINT 

Exit + + 3 (plus) 

Exit+ - "(hyphen) 

Exit + 5 (underscore) 

Exit + 01 through Exit + 24 6 

None— Data and cursor control keys are 
typamatic 7 

Exit + R 8 

Command 

Exit + M 

Exit + Q 
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Table E-3. Key Functions of 91 1 and 91 5 ICS Terminals — Listed by Key 



Key Sequence(s) for 91 1 
and 915 Terminals 



Key Function 



Initialize Input 
Command 
Exit + A 
Exit + D 
Exit + E 
Exit + F 
Exit + 1 

Exit + L 

Exit + M 

Exit + P 

Exit + Q 

Exit+R 

Exit+ + (plus) 

Exit+ - (hyphen) 

Exit + (underscore) 

Exit + 01 through EXIT + 24 

F9 (915 keyboard) 

HOME 

PRINT 

PRINT+ PRINT 

REPEAT 



Clear screen 

Suspend 911 terminal 

Alpha (override numeric protection) 

Duplicate, remote (duplicate previous field) 

Erase to end-of-screen (EOS) 

Field mark 

Identification function (identify or change the print key 
pathname) 

Duplicate, local (duplicate previous field) 

Tab mode toggle (between TABS and WORD) 

Append cursor to the end of a word 

Terminate station 

Reset (unlock keyboard) 

Program access key one, PA1 

Program access key two, PA2 

Program access key three, PA3 

Program function keys, PF1 through PF24 

Suspend 915 terminal 

Home cursor (to the first character position) 

Print screen 

Cancel screen print 

Repeat (extension of the typamatic feature) 
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Table E-4. Key Functions of 931 ICS Terminals — Listed by Key 



Key Sequence(s) 
For 931 Terminal 



Key Function 



Initialize Input 
Command 
Exit + A 
Exit + D 
Exit + E 
Exit+F 
Exit + 1 

Exit + L 

Exit + M 

Exit + P 

Exit + Q 

Exit + R 

Exit+ + (plus) 

Exit+ - (hyphen) 

Exit + (underscore) 

F1 through F12 
HOME 
PRINT 

PRINT+ PRINT 
REPEAT 



Clear screen 

Suspend 931 terminal 

Alpha (override numeric protection) 

Duplicate, remote (duplicate previous field) 

Erase to end-of-screen (EOS) 

Field mark 

Identification function (identify or change the print key 
pathname) 

Duplicate, local (duplicate previous field) 

Tab mode toggle (between TABS and WORD) 

Append cursor to the end of a word 

Terminate station 

Reset (unlock keyboard) 

Program access key one, PA1 

Program access key two, PA2 

Program access key three, PA3 

Program function keys, PF1 through PF12 

Home cursor (to the first character position) 

Print screen 

Cancel screen print 

No repeat key, keyboard is typamatic 
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Table E-5. Key Functions of 940 ICS Terminal — Listed by Key 



Key Sequence(s) for 
940 EVT 



Key Function 



(ALT)P1 

(ALT)P2 

(ALT)P3 

(ALT)' 

ERASE ALL 

ERASE EOF 

ERASE EOL 

ERASE EOS 

or 
PAGE+E 

ERASE INPUT 

F1 through F24 

HOME 

LINEFEED 

NEXT FORM 

Exit + A 

Exit + D 

Exit + F 

Exit + 1 

Exit + L 

Exit+M 

Exit + P 

Exit + Q 

PRINT 

PRINT+ PRINT 

SEND 

SKIP 



Program access key one, PA1 
Program access key two, PA2 
Program access key three, PA3 
Reset (unlock keyboard) 
Clear screen 
Erase field (entire field) 
Skip (erase to end-of-field) 
Erase to end-of-screen (EOS) 

Erase input 

Program function keys, PF1 through PF24 

Home cursor (to the first character position) 

Field right (cursor to next field) 

Suspend 940 terminal 

Alpha (override numeric protection) 

Duplicate, remote (duplicate previous field) 

Field mark 

Identification function (identify or change the print key 
pathname) 

Duplicate, local (duplicate previous field) 

Tab mode toggle (between TABS and WORD) 

Append cursor to the end of a word 

Terminate station 

Print screen 

Cancel print 

Enter (send to host) 

Cursor to the previous field 
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Table E-6. Key Functions of Business System Terminal — Listed by Key 



Key Sequence(s) for 

Small Business 

Systems Terminal 



Key Function 



Initialize input 
Command 
(SHIFT)Exit + A 
(SHIFT)Exit + D 
(SHIFT)Exit + E 
(SHIFT)ExitSC + F 
(SHIFT)Exit + l 

(SHIFT)Exit + L 

(SHIFT)Exit + M 

(SHIFT)Exit + P 

(SHIFT)Exit + Q 

(SHIFT)Exit+R 

(SHIFT)Exit+ + (plus) 

(SHIFT)Exit+ - (hyphen) 

(SHIFT) Exit + (underscore) 

(SHIFT)Exit + 01 

through 
(SHIFT)Exit + 24 

HOME 

PRINT 

PRINT + PRINT 



Clear screen 

Suspend ICS video station 

Alpha (override numeric protection) 

Duplicate, remote (duplicate previous field) 

Erase to end-of-screen (EOS) 

Field mark 

Identification function (identify or change the print key 
pathname) 

Duplicate, local (duplicate previous field) 

Tab mode toggle (between TABS and WORD) 

Append cursor to the end of a word 

Terminate station 

Reset (unlock keyboard) 

Program access key one, PA1 

Program access key two, PA2 

Program access key three, PA3 

Program function keys, PF1 through PF24 

Home cursor (to first character position) 
Print screen 
Cancel print 
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Appendix F 

Binary Synchronous Communications 

(BSC) Procedures 



ICS uses the IBM 3270 Binary Synchronous Communications (BSC) protocol. This protocol uses 
the multipoint data link mode of operation over nonswitched facilities. ICS cannot be attached to 
a line that supports other types of procedures. 

The data transmitted from the ICS control unit is sent over communications lines in blocks of 
data. Each block can have a maximum of 256 characters. The host application program is not 
limited by the 256-character maximum. Every 256-character block includes a start of text (STX) 
character and an end of transmission block (ETB) or an end of text (ETX) character. Block check 
characters (BCCs) follow each block. These characters provide an error check to ensure that all 
characters transmitted are received correctly. 

Included in each transmission are data link control characters. The characters or character 
combinations indicate the beginning and end of each message block, format the block, and 
respond to message blocks. The data link control characters cause the data transmission to 
proceed in an orderly fashion. 

PAD characters precede and follow each transmission. A PAD character ensures that the last 
character of the transmission block is properly sent prior to turning off the transmitting station. 
The PAD character consists of eight one bits (> FF). 

This appendix briefly describes the BSC control characters that the ICS control unit supports. For 
a detailed description and explanation of the 3270 BSC procedures, refer to the IBM 3270 
Information Display System Component Description and the IBM General Information — Binary 
Synchronous Communications. 

ICS supports the following data link control characters: 

Synchronous idle (SYN). The SYN character establishes and maintains synchronization of 
transmission. The synchronization pattern consists of two or more SYN characters that precede 
any control characters or data transmitted. 

Start of heading (SOH). ICS transmits the SOH character in a three-character heading that iden- 
tifies the accompanying data as a status. 

Start of text (STX). The STX character precedes a block of text to place the receiving station in 
the receive mode. STX begins the accumulation of the BCC value that is to be appended to this 
text block. STX is also the first character of a TTD sequence. 

End of intermediate transmission block (ITB). The ICS control unit does not transmit the ITB 
character, but does support the reception of ITB. When a block of text containing ITB is received, 
ITB is removed and the BCC accumulation continues with the value of the BCC character follow- 
ing ITB. 
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End of transmission block (ETB). The ETB character indicates the end of a block of data that was 
preceded by STX or SOH and indicates that the BCC for the block follows immediately. The ETB 
character forces a line turn around, and the receiving station transmits its response. 

End of text (ETX). The ETX character indicates the end of the last block of data of a message that 
was preceded by STX or SOH. A BCC for the block follows immediately. ETX forces a line turn- 
around, and the receiving station transmits an acknowledgment. 

End of transmission (EOT). The ICS control unit transmits an EOT character in the following 
situations: 

• When the ICS control unit cannot perform a request that the host transmits 

• In response to a completed read operation by the host 

• When the host polls and the ICS control unit has no data to transmit 

• In response to a received RVI 

When ICS receives an EOT character, it returns to the state in which it is awaiting a poll or select. 
Enquiry (ENQ). The ICS control unit transmits an ENQ character in the following situations: 

• To request a reply from the IBM transmission control unit after a three-second time-out 
following an ICS transmission 

• To request retransmission of the previous reply 

• As the last character of a text message in which a parity error was detected 

When ICS receives an ENQ character, the last transmission is repeated. 

To be addressed successfully, the ICS control unit must receive ENQ as the last character of a 
poll or select sequence. 

The ENQ character is transmitted with a leading PAD and two SYN characters and followed by a 
trailing PAD character. 

Alternating acknowledgment (ACKO/1). BSC uses the following two alternating acknowledgment 
characters: 

• The ACKO character is an affirmative acknowledgment for line bits and even-numbered 
text blocks. ICS also transmits ACKO after a successful select addressing sequence to 
indicate that it is ready to accept transmission. 

• The ACK1 character is an affirmative acknowledgment for odd-numbered text blocks. 

The ACKO and ACK1 characters are transmitted with leading and trailing PAD characters in the 
same way as an ENQ character. 
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Negative acknowledgment (NAK). ICS transmits the NAK character when it receives text that 
satisfies one of the following conditions: 

• Terminates with an ENQ character 

• Has an embedded ENQ character 

• Has a BCC character with an invalid value 

• Contains a TTD sequence (STX ENQ) 

• Hasan ETX character missing 

When ICS receives a NAK character in response to a data transmission, ICS resends the last block 
of data. 

Wait before transmitting, positive acknowledgment (WACK). ICS transmits the WACK character 
when it is unable to receive data on a select. ICS responds to a WACK character with an ENQ 
character. 

Data link escape (DLE). The DLE character provides supplementary line control characters such 
as WACK, ACKO/1, and RVI. The DLE character enables the transmission of control characters in 
transparent text. The ICS control unit does not operate in transparent mode, but it can operate on 
a communications line with stations that use the transparent mode. 

Reverse interrupt (RVI). ICS transmits the RVI character when it receives a select while it has a 
pending status or sense message to send. ICS transmits an EOT character and resets all pending 
status and sense information whenever it receives an RVI character. 

Escape (ESC). The ESC character precedes the command code in each command sequence data 
stream that ICS receives. 

Temporary text delay (TTD). ICS does not transmit a TTD sequence, but it responds to TTD by 
transmitting NAK and then awaiting EOT. 

Line error detection. ICS detects transmission errors by using a cyclic redundancy check (CRC) 
that it performs on the received data. The transmitting station makes CRCs possible by 
generating a value for the block check character (BCC) that it appends to the end of each message 
block transmitted (after an ITB, ETB, or ETX character). The value of the BCC (16 bits) is generated 
by a cyclic process in which each data bit is manipulated by a preset check polynomial. This poly- 
nomial checks that the data transmitted is exactly the same as that received. All characters, 
except SYN following an STX or SOH character, are included in the CRC. The CRC value also 
counts the ETB and ETX characters. 

If ICS detects an error during transmission of a data block, it responds with a NAK character. If 
ICS detects an error when it is expecting a control function, it responds with an ENQ character. 
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Introduction 



HOW TO USE INDEX 

The index, table of contents, list of illustrations, and list of tables are used in conjunction to ob- 
tain the location of the desired subject. Once the subject or topic has been located in the index, 
use the appropriate paragraph number, figure number, or table number to obtain the corre- 
sponding page number from the table of contents, list of illustrations, or list of tables. 

INDEX ENTRIES 

The following index lists key words and concepts from the subject material of the manual together 
with the area(s) in the manual that supply major coverage of the listed concept. The numbers along 
the right side of the listing reference the following manual areas: 

• Sections — Reference to Sections of the manual appear as "Sections x" with the sym- 
bol x representing any numeric quantity. 

• Appendixes — Reference to Appendixes of the manual appear as "Appendix y" with the 
symbol y representing any capital letter. 

• Paragraphs — Reference to paragraphs of the manual appear as a series of 
alphanumeric or numeric characters punctuated with decimal points. Only the first 
character of the string may be a letter; all subsequent characters are numbers. The first 
character refers to the section or appendix of the manual in which the paragraph may be 
found. 

• Tables — References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number. 

Tx-yy 

• Figures — References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number. 

Fx-yy 

• Other entries in the Index — References to other entries in the index preceded by the 
word "See" followed by the referenced entry. 
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Abort Count 4.4.4 

Access: 

Key, Program 3.4.4.13 

Print Queue 2.5.2.4, 3.2.1.3 

Activate: 
Communications Controller Task . . . 4.2.2 
Option 5.3.1 

Activation: 

Printer 3.2.2 

Video Terminal 3.2 

Active: 

PSC 4.3.1 

State 4.3.1 

Add-on Package 5.5 

Address: 
Auto-Select: 

Control Unit 2.3.1,4.3.1,5.2.4.1,5.7 

Decimal to EBCDIC 2.3 

EBCDIC to Decimal 2.3 

Mapping: 

Poll 4.3.1 

Terminal 2.3.2,2.5.2.4,3.2.1.2, 

3.2.2.2,3.3.2.1,4.3.1,5.2.4.2 

AID Code 3.4.4.13, 5.3.5.4 

Alarm, Audible 3.4.3.2 

Alpha Function 3.4.4.12 

Analyzer, Execute Poll 4.5 

Application: 

Command, Host 5.2.3 

Order, Host 5.2.3 

Arguments: 

Close 5.3.7.2 

Fill 5.3.2.2 

Get 5.3.3.2 

Open 5.3.1.2 

Retrieve Attributes 5.3.4.2 

Time-out 5.3.6.2 

Transmit 5.3.5.2 

Attention: 

ID Code 3.4.4.13, 5.3.5.4 

Key, Program 3.4.4.13 

Attribute: 

Arguments 5.3.4.2 

Call 5.3.4 

Call, Retrieve 5.3.4.1 

Character 3.4.2.1, 5.2.2 

Example 5.3.4.4 

Location 5.2.2.2 

Routine 5.3.4 

Audible Alarm 3.4.3.2 

Automatic Skip 3.4.3.1 

Auto-Select: 
Communications Line 

Control Unit Address 5.2.4.1, 5.7 

Name 2.5.2.4, 5.2.4.1, 5.7 

Terminal Address 2.5.2.4, 5.2.4.2, 5.7 

Binary Synchronous Communications 

Procedures Appendix F 

Blank Gray Key 3.4.4.13 



Blinking Cursor 3.4.2.1, 3.4.4.8 

Block Count 4.4.2 

BSC Appendix F 

Buffer: 

Error 4.4.9 

PSC Station 5.2.1 

Business System Terminal: 

Description 2.2.1.4 

Keyboard 3.4.1 

Station, Suspend 3.3.1.4 

Call: 

Close 5.3.7.1 

Example 5.4.5 

Fill 5.3.2.1 

Get 5.3.3.1 

Open 5.3.1.1 

Retrieve Attributes 5.3.4.1 

Time-out 5.3.6.1 

Transmit 5.3.5.1 

Cancel Print 3.4.4.8 

CHAR Key, INS 3.4.4.5 

Character: 

Attribute 3.4.2.1, 5.2.2 

Key, Insert 3.4.4.5 

Clear Key 3.4.4.13 

Close: 

Arguments 5.3.7.2 

Call 5.3.7.1 

Example 5.3.7.4 

Routine 5.3.7 

Code: 

AID 3.4.4.13,5.3.5.4 

Attention ID 3.4.4.13, 5.3.5.4 

Completion 5.2.5 

Command: 

Host Application 5.2.3 

Interpreter, System 2.5.1 

LICC 4.3.1 

LICS 4.4 

MCUA 4.3.3 

MICC 4.3.2 

QICT 3.4.2.1 

PTPSC 5.6 

Reject 4.4.5 

Summary, SCI Appendix E, 2.6 

XICC 4.2.2 

XICP 3.3.2 

XICT 3.3.1 

XPA 4.5 

XPSC 5.7 

Communications: 

Auto-Select 2.5.2.4, 5.2.4.1, 5.7 

Controller C.2, C.3 

Line 4.2.2 

Name 2.5.2.4, 3.2.1.1, 3.2.2.1, 3.3.2.1 

Task, Activate 4.2.2 

Completion Code 5.2.5 

Components, ICS 1.4 

Conditions, Printer Error 4.8.4 
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Configuration: 
List Interactive Communications . . . 4.3.1 
Modify Interactive 

Communications 4.3.2 

Control Unit Address 2.3.1, 4.2.2, 4.3.1 

Auto-Select 5.2.4.1, 5.7 

Modify 4.3.3 

Controller: 

Communications C.2, C.3 

Remote Terminal 2.2, 2.2.2.1 

Conventions 1.3 

Count: 

Abort 4.4.4 

Block 4.4.2 

Message 4.4.1 

Retransmission 4.4.3 

Cursor 3.4.2.3 

Blinking 3.4.2.1, 3.4.4.8 

Movement Key 3.4.4.2 

Wrap 3.4.4.2 

Data Service Unit 2.4.1 .1 , C.3 

Decimal-to-EBCDIC Address 

Mapping 2.3 

Delete Character Key 3.4.4.5 

Development Aid, Program 5.4 

Device Name 2.5.2.1 

Digital Data System 2.4.1 .1 , C.3 

Disabled State 4.3.1 

Display: 

Format 3.4.2.1 

Unformatted 3.4.2.2 

DSU 2.4.1.1, C.3 

DUMY 2.5.2.4 

DUP 3.4.4.10 

Duplicate Function: 

Local 3.4.4.10 

Remote 3.4.4.10 

EBCDIC-to-Decimal Address 

Mapping 2.3 

Edit Key 3.4.4.5 

EM Order 4.8.3, 5.2.3 

Emulator Components 1.4 

End-of-Message Order 4.8.3, 5.2.3 

End-of-Screen, Erase to 3.4.4.5 

Enter Function 3.4.4.13 

ENTER Key 3.4.4.13 

EOS Function, Erase to 3.4.4.5 

ERASE FIELD Key 3.4.4.5 

ERASE INPUT Key 3.4.4.5 

Erase to End-of-Screen 3.4.4.5 

Erase to EOS Function 3.4.4.5 

Error: 

Buffer 4.4.9 

Conditions, Printer 4.8.4 

Messages Appendix B 



Poll 4.4.7 

Printer Station 3.2.2.5 

PSC B.4 

Select 4.4.8 

Example: 

Call 5.4.5 

Close 5.3.7.4 

Fill 5.3.2.4 

Get 5.3.3.4 

Open 5.3.1.4 

Retrieve Attributes 5.3.4.4 

Time-out 5.3.6.4 

Transmit 5.3.5.4 

Execute: 

Poll Analyzer 4.5 

PSCTask 5.7 

Extended: 

Features 1 .7 

Function Mode 3.4.2.3 

Key Function 3.4.1 

Features: 

Extended 1 .7 

Supported 1 .6 

Unsupported 1.8 

FF Order 4.8.3, 5.2.3 

FIELD Key, ERASE 3.4.4.5 

Field Mark Function 3.4.4.11 

Field Movement Key 3.4.4.3 

File: 

Local Format 4.7, 4.8.4, 4.9, 5.2.4.1 

Pathname 2.5.2.2 

Program 5.5, 5.6 

Fill: 

Arguments 5.3.2.2 

Call 5.3.2.1 

Example 5.3.2.4 

Routine 5.3.2 

Form Feed Order 4.8.3, 5.2.3 

Format: 

Display 3.4.2.1 

File, Local 4.7, 4.8.4, 5.2.4.1 

Print Line 4.8.3, 5.2.3 

Function: 

Alpha 3.4.4.12 

Clear 3.4.4.13 

Duplicate 3.4.4.10 

Enter 3.4.4.13 

Erase to EOS 3.4.4.5 

Extended Key 3.4.1 

Field Mark 3.4.4.11 

Identification 3.4.4.8 

Local Duplicate 3.4.4.10 

Mode, Extended 3.4.2.3 

Print 3.4.4.8 

Program 3.4.4.13 

Remote Duplicate 3.4.4.10 
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Get: 

Arguments 5.3.3.2 

Call 5.3.3.1 

Example 5.3.3.4 

Routine 5.3.3 

Host Application: 

Command 5.2.3 

Order 5.2.3 

ID: 

Code, Attention 5.3.5.4 

Run 4.3.1 

Task 5.6, 5.7 

Ident 3.4.4.8 

Identification: 

Function 3.4.4.8 

PSC Station 5.2.4 

Idle State 4.3.1 

Initial Value 2.5.2.4 

Initialize System 4.2 

INPUT Key, ERASE 3.4.4.5 

INS CHAR Key 3.4.4.5 

Insert Character Key 3.4.4.5 

Installation 4.2 

Multiple Line 2.2.3 

Interpreter, System Command 2.5.1 

IS 4.2 

Key: 

Access 3.4.4.13 

Attention 3.4.4.13 

Clear 3.4.4.13 

Cursor Movement 3.4.4.2 

DEL CHAR 3.4.4.5 

Delete Character 3.4.4.5 

Edit 3.4.4.5 

ENTER 3.4.4.13 

ERASE: 

FIELD 3.4.4.5 

INPUT 3.4.4.5 

Field Movement 3.4.4.3 

Function, Extended 3.4.1 

INS CHAR 3.4.4.5 

Insert Character 3.4.4.5 

Mode 3.4.4.1 

Pathname, PRINT .. 2.5.2.4,3.2.1.3,3.4.4.8 

PRINT 3.4.4.8 

REPEAT 3.4.4.1 

RETURN 3.4.4.3 

SKIP 3.4.4.5 

Function 3.4.4.13 

Keyboard: 
Lock 3.4.1, 3.4.4.9, 3.4.4.13 

Length Order, Line 4.8.3 

Library, Object 5.5, 5.6 

LICC 4.3.1 

LICS 4.4 



Line: 

Auto-Select Communications .. 2.5.2.4, 

5.2.4.1,5.7 

Communications 2.5.2.4,3.2.1.1, 

5.7,3.2.2.1,3.3.2.1,4.2.2 

Format, Print 4.8.3, 5.2.3 

Installation, Multiple 2.2.3 

Length Order 4.8.3 

Link PSC 5.5 

List Interactive Communications: 

Configuration 4.3.1 

Statistics 4.4 

Local: 

Duplicate Function 3.4.4.10 

Format File 4.7, 4.8.4, 4.9, 5.2.4.1 

Location, Attribute 5.2.2.2 

Lock, Keyboard 3.4.1 , 3.4.4.9, 3.4.4.13 

Log Messages B.2 

LUNO, Required 4.2.1 

Mapping: 

Decimal-to-EBCDIC Address 2.3 

EBCDIC-to-Decimal Address 2.3 

Mark Function, Field 3.4.4.11 

Maximum Terminals Supported 1.4.2 

MCUA 4.3.3 

Memory Requirements C.1 

Menu 2.6 

Message: 

Count 4.4.1 

Variants B.2 

Messages: 

Error Appendix B 

Log B.2 

PSC Error B.4 

Station B.2 

MICC 4.3.2 

Mode: 

Extended Function 3.4.2.3 

Key 3.4.4.1 

TABS 3.4.4.4 

WORD 3.4.4.4 

Modem C.2 

Modify Interactive Communications 

Configuration 4.3.2 

Module: 

Object 5.5 

Patch 5.5 

Movement Key: 

Cursor 3.4.4.2 

Field 3.4.4.3 

Multiple Line Installation 2.2.3 

Name: 
Auto-Select Communications 
Communications Line .... 2.5.2.4, 3.2.1.1, 

3.2.2.1,3.3.2.1 
Device 2.5.2.1 



lndex-4 



2250954-9701 



Index 



Line 2.5.2.4, 5.2.4.1, 5.7 

Task 5.6, 5.7 

New Line Function 3.4.4.3 

New Line Order 4.8.3 

NLOrder 4.8.3,5.2.3 

Nonreplicatable 5.5 

Null Value 2.5.2.4 

Object: 

Library 5.5, 5.6 

Module 5.5 

Open: 

Arguments 5.3.1.2 

Call 5.3.1.1 

Example 5.3.1.4 

Routine 5.3.1 

Option: 

Activate 5.3.1 

Terminate 5.3.7 

Order: 

EM 4.8.3, 5.2.3 

End of Message 4.8.3, 5.2.3 

FF 4.8.3, 5.2.3 

Form Feed 4.8.3, 5.2.3 

Host Application 5.2.3 

Line Length 4.8.3 

New Line 4.8.3 

NL 4.8.3,5.2.3 

Output Pathname 2.5.2.4, 3.2.2.3 

Patch: 

Module 5.5 

PSC Programs 5.6 

Pathname: 

File 2.5.2.2 

Output 3.2.2.3 

PRINT Key 2.5.2.4, 3.2.1 .3, 3.4.4.8 

Prompt, Output 2.5.2.4 

Terminal 3.3.2.1 

Poll 1.2 

Address 4.3.1 

Analyzer, Execute 4.5 

Error 4.4.7 

Primitive, SCI 3.3.1, 3.3.2.1, 4.2.2 

Print Cancel 3.4.4.8 

Print Function 3.4.4.8 

PRINT Key 3.4.4.8 

Pathname 2.5.2.4, 3.2.1 .3, 3.4.4.8 

Print Line Format 4.8.3, 5.2.3 

Print Queue Access 2.5.2.4, 3.2.1.3 

Printer: 

Activation 3.2.2 

Error 3.2.2.5 

Error Conditions 4.8.4 

Time-out 4.8.4 

Supported 1.4.2.2 

Priority Level, PSC 5.5 

Procedures, Binary Synchronous 
Communications Appendix F 



Program: 

Access Key 3.4.4.13 

Attention Key 3.4.4.13 

Development Aid 5.4 

File 5.5,5.6 

Function Key 3.4.4.13 

Prompt, Output Pathname 2.5.2.4 

PSC - 

Active State 4.3.1 

Buffer 5.2.1 

Error Messages B.4 

Identification 5.2.4 

Link 5.5 

Priority Level 5.5 

Proarams, Patch 5.6 

TasR, Execute 5.7 

Waiting State 4.3.1 

PTPSC 5.6 



Queue Access, Print 



2.5.2.4,3.2.1.3 



Reject, Command 4.4.5 

Remote: 

Duplicate Function 3.4.4.10 

Terminal: 

Controller 2.2, 2.2.2.1 

Subsystem 2.2, 2.2.2 

Video Terminal 2.2.1 .2, 2.2.2.1 , 2.2.2.2 

REPEAT Key 3.4.4.1 

Required LUNO 4.2.1 

Requirements, Memory C.2 

Reset 3.4.4.9 

Retransmission Count 4.4.3 

Retrieve Attributes: 

Arguments 5.3.4.2 

Call 5.3.4.1 

Example 5.3.4.4 

Routine 5.3.4 

RETURN Key 3.4.4.3 

Routine: 

Close 5.3.7 

Fill 5.3.2 

Get 5.3.3 

Open 5.3.1 

Retrieve Attributes 5.3.4 

Time-out 5.3.6 

Transmit 5.3.5 

RTC 2.2,2.2.2.1 

RTS 2.2, 2.2.2 

Run ID, Task 4.3.1 

RVT, Model 915 2.2.1.2, 2.2.2.1, 2.2.2.2 

SCI 2.5.1 

Command Summary Appendix E, 2.6 

Primitive 3.3.1,3.3.2.1,4.2.2 

Select 1.2 

Error 4.4.8 

Services Unit, Data 2.4.1.1, C.3 

Skip, Automatic 3.4.3.1 
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SKIP Key 3.4.4.5 

State: 

Active 4.3.1 

Disabled 4.3.1 

Idle 4.3.1 

Waiting 4.3.1 

Suspended 4.3.1 

Terminal 4.3.1 

Station: 

Buffer, PSC 5.2.1 

Error, Printer 3.2.2.5 

Identification, PSC 5.2.4 

Messages B.2 

Terminate 3.3.2.1, 3.4.4.7 

Statistics, List Interactive 
Communications 4.4 

Subsystem, Remote Terminal 2.2,2.2.2 

Supported: 

Features 1 .6 

Printers 1 .4.2.2 

Suspend: 

Business System Terminal 3.3.1.4 

911 Station 3.3.1.1 

915 Station 3.3.1 .2 

940 EVT 3.3.1.3 

Video Terminal 3.3.1, 3.4.4.6 

Suspended State 4.3.1 

Synchronous Communications 
Procedures, Binary Apppendix F 

Synonym 2.5.2.3 

System: 

Command Interpreter 2.5.1 

Initialize 4.2 

TAB Key 3.4.4.4 

TABS Mode 3.4.4.4 

Task: 

Execute PSC 5.7 

ID 5.6, 5.7 

Name 5.6, 5.7 

Run ID 4.3.1 

Segment 5.5, 5.6 

Terminal: 

Activation, Video 3.2 

Address 3.2, 2.5.2.4, 3.2.1 .2, 

3.2.2.2,3.3.2.1,4.3.1,5.2.4.2 

Address, Auto-Select 2.5.2.4, 

5.2.4.2, 5.7 

Controller, Remote 2.2, 2.2.2.1 

Pathname 3.3.2.1 

Remote Video 2.2.1.2, 2.2.2.2 

State 4.3.1 

Subsystem, Remote 2.2, 2.2.2 

Supported, Maximum 1.4.2 



Suspend Video 3.3.1, 3.4.4.6 

Type 3.3.2.1, 4.3.1, 5.2.4.2 

Terminate: 

Option 5.3.7 

Station 3.3.2.1, 3.4.4.7 

Time-out: 

Arguments 5.3.6.2 

Call 5.3.6.1 

Example 5.3.6.4 

Printer Station 4.8.4 

Routine 5.3.6 

Transmit: 

Arguments 5.3.5.2 

Call 5.3.5.1 

Example 5.3.5.4 

Routine 5.3.5 

Type, Terminal 3.3.2.1,4.3.1,5.2.4.2 

Unformatted Display 3.4.2.2 

Unit: 
Address, Auto-Select Control .. 5.2.4.1,5.7 
Digital Services C.3 

Unsupported Features 1.8 

Variant, Message B.2 

VDT, Model 911 2.2.1.1 

Video Terminal: 

Activation 3.2 

Business System 2.2.1.4 

911 2.2.1.1 

915 Remote 2.2.1.2 

940 2.2.1.3 

Remote 2.2.1.2, 2.2.2.2 

Suspend 3.3.1, 3.4.4.6 

Waiting State, PSC 4.3.1 

WORD Mode 3.4.4.4 

Wrap, Cursor 3.4.4.2 

XICC 4.2.2 

XPA 4.5 

XPSC 5.7 

911: 

Station, Suspend 3.3.1 .1 

Video Display Terminal 2.2.1 .1 

915: 

Remote Video Terminal 2.2.1.2, 

2.2.2.1,2.2.2.2 
Station, Suspend 3.3.1.2 

940: 

Editing Video Terminal 2.2.1.3,2.2.2.3 

Station, Suspend 3.3.1.3 
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